Source Code
Overview
ETH Balance
0 ETH
More Info
ContractCreator
Multichain Info
N/A
| Transaction Hash |
Method
|
Block
|
From
|
To
|
Amount
|
||||
|---|---|---|---|---|---|---|---|---|---|
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:
AGWAccount
Compiler Version
v0.8.26+commit.8a97fa7a
ZkSolc Version
v1.5.6
Optimization Enabled:
Yes with Mode 3
Other Settings:
cancun EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {IAccount, ACCOUNT_VALIDATION_SUCCESS_MAGIC} from '@matterlabs/zksync-contracts/l2/system-contracts/interfaces/IAccount.sol';
import {Transaction, TransactionHelper} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/TransactionHelper.sol';
import {EfficientCall} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/EfficientCall.sol';
import {BOOTLOADER_FORMAL_ADDRESS, NONCE_HOLDER_SYSTEM_CONTRACT, DEPLOYER_SYSTEM_CONTRACT, INonceHolder} from '@matterlabs/zksync-contracts/l2/system-contracts/Constants.sol';
import {SystemContractsCaller} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/SystemContractsCaller.sol';
import {SystemContractHelper} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/SystemContractHelper.sol';
import {Utils} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/Utils.sol';
import {Initializable} from '@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol';
import {HookManager} from './managers/HookManager.sol';
import {ModuleManager} from './managers/ModuleManager.sol';
import {UpgradeManager} from './managers/UpgradeManager.sol';
import {TokenCallbackHandler, IERC165} from './helpers/TokenCallbackHandler.sol';
import {Errors} from './libraries/Errors.sol';
import {SignatureDecoder} from './libraries/SignatureDecoder.sol';
import {ERC1271Handler} from './handlers/ERC1271Handler.sol';
import {Call} from './batch/BatchCaller.sol';
import {IAGWAccount} from './interfaces/IAGWAccount.sol';
import {OperationType} from './interfaces/IValidator.sol';
import {AccountFactory} from './AccountFactory.sol';
import {BatchCaller} from './batch/BatchCaller.sol';
/**
* @title Main account contract for the Abstract Global Wallet infrastructure
* @dev Forked from Clave for Abstract
* @dev The Abstract fork uses a K1 signer and validator initially
* @author https://getclave.io
* @author https://abs.xyz
*/
contract AGWAccount is
Initializable,
UpgradeManager,
HookManager,
ModuleManager,
ERC1271Handler,
TokenCallbackHandler,
BatchCaller,
IAGWAccount
{
// Helper library for the Transaction struct
using TransactionHelper for Transaction;
uint256 public constant VERSION = 1;
address public immutable KNOWN_TRUSTED_EOA_VALIDATOR;
/**
* @notice Constructor for the account implementation
*/
constructor(address knownTrustedEoaValidator) {
KNOWN_TRUSTED_EOA_VALIDATOR = knownTrustedEoaValidator;
_disableInitializers();
}
/**
* @notice Initializer function for the account contract
* @param initialK1Owner bytes address - The initial k1 owner of the account
* @param initialK1Validator address - The initial k1 validator of the account
* @param modules bytes[] calldata - The list of modules to enable for the account
* @param initCall Call calldata - The initial call to be executed after the account is created
*/
function initialize(
address initialK1Owner,
address initialK1Validator,
bytes[] calldata modules,
Call calldata initCall
) public payable initializer {
__ERC1271Handler_init();
// check that this account is being deployed by the initial signer or the factory authorized deployer
AccountFactory factory = AccountFactory(msg.sender);
// require a specific salt for the acccount based on the initial k1 owner
address expectedAddress = factory.getAddressForSalt(keccak256(abi.encodePacked(initialK1Owner)));
if (address(this) != expectedAddress) {
revert Errors.INVALID_SALT();
}
// add the initial k1 owner as an owner
_k1AddOwner(initialK1Owner);
address thisDeployer = factory.accountToDeployer(address(this));
if (!factory.authorizedDeployers(thisDeployer)) {
if (initialK1Owner != thisDeployer) {
// disregard any modules and initial call as the deployer is untrusted
_k1AddValidator(KNOWN_TRUSTED_EOA_VALIDATOR);
return;
}
}
_k1AddValidator(initialK1Validator);
for (uint256 i = 0; i < modules.length; ) {
_addModule(modules[i]);
unchecked {
i++;
}
}
if (initCall.target != address(0)) {
uint128 value = Utils.safeCastToU128(initCall.value);
_executeCall(initCall.target, value, initCall.callData, initCall.allowFailure);
}
}
// Receive function to allow ETH to be sent to the account
// with no additional calldata
receive() external payable {}
// Fallback function to allow ETH to be sent to the account
// with arbitrary calldata to mirror the behavior of an EOA
fallback() external payable {
// Simulate the behavior of the EOA if it is called via `delegatecall`.
address codeAddress = SystemContractHelper.getCodeAddress();
if (codeAddress != address(this)) {
// If the function was delegate called, behave like an EOA.
assembly {
return(0, 0)
}
}
// fallback of default account shouldn't be called by bootloader under any circumstances
assert(msg.sender != BOOTLOADER_FORMAL_ADDRESS);
// If the contract is called directly, behave like an EOA
}
/**
* @notice Called by the bootloader to validate that an account agrees to process the transaction
* (and potentially pay for it).
* @dev The developer should strive to preserve as many steps as possible both for valid
* and invalid transactions as this very method is also used during the gas fee estimation
* (without some of the necessary data, e.g. signature).
* @param - bytes32 - Not used
* @param suggestedSignedHash bytes32 - The suggested hash of the transaction that is signed by the signer
* @param transaction Transaction calldata - The transaction itself
* @return magic bytes4 - The magic value that should be equal to the signature of this function
* if the user agrees to proceed with the transaction.
*/
function validateTransaction(
bytes32,
bytes32 suggestedSignedHash,
Transaction calldata transaction
) external payable override onlyBootloader returns (bytes4 magic) {
_incrementNonce(transaction.nonce);
// The fact there is enough balance for the account
// should be checked explicitly to prevent user paying for fee for a
// transaction that wouldn't be included on Ethereum.
if (transaction.totalRequiredBalance() > address(this).balance) {
revert Errors.INSUFFICIENT_FUNDS();
}
// While the suggested signed hash is usually provided, it is generally
// not recommended to rely on it to be present, since in the future
// there may be tx types with no suggested signed hash.
bytes32 signedHash = suggestedSignedHash == bytes32(0)
? transaction.encodeHash()
: suggestedSignedHash;
magic = _validateTransaction(signedHash, transaction);
}
/**
* @notice Called by the bootloader to make the account execute the transaction.
* @dev The transaction is considered successful if this function does not revert
* @param - bytes32 - Not used
* @param - bytes32 - Not used
* @param transaction Transaction calldata - The transaction itself
*/
function executeTransaction(
bytes32,
bytes32,
Transaction calldata transaction
) external payable override onlyBootloader {
_executeTransaction(transaction);
}
/**
* @notice This function allows an EOA to start a transaction for the account.
* @dev There is no point in providing possible signed hash in the `executeTransactionFromOutside` method,
* since it typically should not be trusted.
* @param transaction Transaction calldata - The transaction itself
*/
function executeTransactionFromOutside(
Transaction calldata transaction
) external payable override {
// Check if msg.sender is authorized
if (!_k1IsOwner(msg.sender)) {
revert Errors.UNAUTHORIZED_OUTSIDE_TRANSACTION();
}
// Extract hook data from transaction.signature
bytes[] memory hookData = SignatureDecoder.decodeSignatureOnlyHookData(
transaction.signature
);
// Get the hash of the transaction
bytes32 signedHash = transaction.encodeHash();
// Run the validation hooks
if (!runValidationHooks(signedHash, transaction, hookData)) {
revert Errors.VALIDATION_HOOK_FAILED();
}
_incrementNonce(transaction.nonce);
_executeTransaction(transaction);
}
/**
* @notice This function allows the account to pay for its own gas and used when there is no paymaster
* @param - bytes32 - not used
* @param - bytes32 - not used
* @param transaction Transaction calldata - Transaction to pay for
* @dev "This method must send at least `tx.gasprice * tx.gasLimit` ETH to the bootloader address."
*/
function payForTransaction(
bytes32,
bytes32,
Transaction calldata transaction
) external payable override onlyBootloader {
bool success = transaction.payToTheBootloader();
if (!success) {
revert Errors.FEE_PAYMENT_FAILED();
}
emit FeePaid();
}
/**
* @notice This function is called by the system if the transaction has a paymaster
and prepares the interaction with the paymaster
* @param - bytes32 - not used
* @param - bytes32 - not used
* @param transaction Transaction - The transaction itself
*/
function prepareForPaymaster(
bytes32,
bytes32,
Transaction calldata transaction
) external payable override onlyBootloader {
transaction.processPaymasterInput();
}
/// @dev type(IAGWAccount).interfaceId indicates AGW accounts
function supportsInterface(
bytes4 interfaceId
) public view override(IERC165, TokenCallbackHandler) returns (bool) {
return
interfaceId == type(IAGWAccount).interfaceId || super.supportsInterface(interfaceId);
}
function _validateTransaction(
bytes32 signedHash,
Transaction calldata transaction
) internal returns (bytes4 magicValue) {
if (transaction.signature.length == 65) {
// This is a gas estimation
return bytes4(0);
}
// Extract the signature, validator address and hook data from the transaction.signature
(bytes memory signature, address validator, bytes[] memory hookData) = SignatureDecoder
.decodeSignature(transaction.signature);
// Run validation hooks
bool hookSuccess = runValidationHooks(signedHash, transaction, hookData);
// Handle validation
bool valid = _handleValidation(validator, OperationType.Transaction, signedHash, signature);
magicValue = (hookSuccess && valid) ? ACCOUNT_VALIDATION_SUCCESS_MAGIC : bytes4(0);
}
function _executeTransaction(
Transaction calldata transaction
) internal runExecutionHooks(transaction) {
address to = _safeCastToAddress(transaction.to);
uint128 value = Utils.safeCastToU128(transaction.value);
bytes calldata data = transaction.data;
_executeCall(to, value, data, false);
}
function _executeCall(
address to,
uint128 value,
bytes calldata data,
bool allowFailure
) internal {
uint32 gas = Utils.safeCastToU32(gasleft());
if (to == address(DEPLOYER_SYSTEM_CONTRACT)) {
// Note, that the deployer contract can only be called
// with a "systemCall" flag.
(bool success, bytes memory returnData) = SystemContractsCaller
.systemCallWithReturndata(gas, to, value, data);
if (!success && !allowFailure) {
assembly {
let size := mload(returnData)
revert(add(returnData, 0x20), size)
}
}
} else {
bool success = EfficientCall.rawCall(gas, to, value, data, false);
if (!success && !allowFailure) {
EfficientCall.propagateRevert();
}
}
}
function _incrementNonce(uint256 nonce) internal {
SystemContractsCaller.systemCallWithPropagatedRevert(
uint32(gasleft()),
address(NONCE_HOLDER_SYSTEM_CONTRACT),
0,
abi.encodeCall(INonceHolder.incrementMinNonceIfEquals, (nonce))
);
}
function _safeCastToAddress(uint256 value) internal pure returns (address) {
if (value > type(uint160).max) revert();
return address(uint160(value));
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {DEPLOYER_SYSTEM_CONTRACT, IContractDeployer} from '@matterlabs/zksync-contracts/l2/system-contracts/Constants.sol';
import {SystemContractsCaller} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/SystemContractsCaller.sol';
import {Ownable, Ownable2Step} from '@openzeppelin/contracts/access/Ownable2Step.sol';
import {EfficientCall} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/EfficientCall.sol';
import {Errors} from './libraries/Errors.sol';
import {IAGWRegistry} from './interfaces/IAGWRegistry.sol';
/**
* @title Factory contract to create AGW accounts
* @dev Forked from Clave for Abstract
* @author https://abs.xyz
* @author https://getclave.io
*/
contract AccountFactory is Ownable2Step {
/**
* @notice Address of the account implementation
*/
address public implementationAddress;
/**
* @notice Allowed selector for account initialization
*/
bytes4 public initializerSelector;
/**
* @notice Account registry contract address
*/
address public registry;
/**
* @notice Account creation bytecode hash
*/
bytes32 public proxyBytecodeHash;
/**
* @notice Authorized deployers of AGW accounts
*/
mapping (address deployer => bool authorized) public authorizedDeployers;
/**
* @notice Tracks the initial deployer of each account
*/
mapping (address account => address deployer) public accountToDeployer;
/**
* @notice Account address deployed for a given salt the same account
* @dev This is used to override the deterministic account address if the account is already deployed
* and the initial implementation has been changed
*/
mapping (bytes32 salt => address accountAddress) public saltToAccount;
/**
* @notice Event emmited when a new AGW account is created
* @param accountAddress Address of the newly created AGW account
*/
event AGWAccountCreated(address indexed accountAddress);
/**
* @notice Event emmited when a new AGW account is deployed
* @param accountAddress Address of the newly deployed AGW account
*/
event AGWAccountDeployed(address indexed accountAddress);
/**
* @notice Event emmited when a deployer account is authorized
* @param deployer Address of the deployer account
* @param authorized Whether the deployer is authorized to deploy AGW accounts
*/
event DeployerAuthorized(address indexed deployer, bool indexed authorized);
/**
* @notice Event emmited when the implementation contract is changed
* @param newImplementation Address of the new implementation contract
*/
event ImplementationChanged(address indexed newImplementation);
/**
* @notice Event emmited when the registry contract is changed
* @param newRegistry Address of the new registry contract
*/
event RegistryChanged(address indexed newRegistry);
/**
* @notice Constructor function of the factory contract
* @param _implementation address - Address of the implementation contract
* @param _registry address - Address of the registry contract
* @param _proxyBytecodeHash address - Hash of the bytecode of the AGW proxy contract
* @param _deployer address - Address of the account authorized to deploy AGW accounts
*/
constructor(
address _implementation,
bytes4 _initializerSelector,
address _registry,
bytes32 _proxyBytecodeHash,
address _deployer,
address _owner
) Ownable(_owner) {
implementationAddress = _implementation;
emit ImplementationChanged(_implementation);
initializerSelector = _initializerSelector;
registry = _registry;
proxyBytecodeHash = _proxyBytecodeHash;
authorizedDeployers[_deployer] = true;
emit DeployerAuthorized(_deployer, true);
}
/**
* @notice Deploys a new AGW account
* @dev Account address depends only on salt
* @param salt bytes32 - Salt to be used for the account creation
* @param initializer bytes memory - Initializer data for the account
* @return accountAddress address - Address of the newly created AGW account
*/
function deployAccount(
bytes32 salt,
bytes calldata initializer
) external payable returns (address accountAddress) {
if (saltToAccount[salt] != address(0)) {
revert Errors.ALREADY_CREATED();
}
// Check that the initializer is not empty
if (initializer.length < 4) {
revert Errors.INVALID_INITIALIZER();
}
// Check that the initializer selector is correct
{
bytes4 selector = bytes4(initializer[0:4]);
if (selector != initializerSelector) {
revert Errors.INVALID_INITIALIZER();
}
}
// Deploy the implementation contract
(bool success, bytes memory returnData) = SystemContractsCaller.systemCallWithReturndata(
uint32(gasleft()),
address(DEPLOYER_SYSTEM_CONTRACT),
uint128(0),
abi.encodeCall(
DEPLOYER_SYSTEM_CONTRACT.create2Account,
(
salt,
proxyBytecodeHash,
abi.encode(implementationAddress),
IContractDeployer.AccountAbstractionVersion.Version1
)
)
);
if (!success) {
revert Errors.DEPLOYMENT_FAILED();
}
// Decode the account address
(accountAddress) = abi.decode(returnData, (address));
// Store the deployer of the account
accountToDeployer[accountAddress] = msg.sender;
saltToAccount[salt] = accountAddress;
// This propagates the revert if the initialization fails
EfficientCall.call(gasleft(), accountAddress, msg.value, initializer, false);
IAGWRegistry(registry).register(accountAddress);
emit AGWAccountDeployed(accountAddress);
}
/**
* @notice To emit an event when a AGW account is created but not yet deployed
* @dev This event is so that we can index accounts that are created but not yet deployed
* @param accountAddress address - Address of the AGW account that was created
*/
function agwAccountCreated(address accountAddress) external {
if (!authorizedDeployers[msg.sender]) {
revert Errors.NOT_FROM_DEPLOYER();
}
emit AGWAccountCreated(accountAddress);
}
/**
* @notice Sets authorization to deploy AGW accounts
* @param deployer address - Address of the new account authorized to deploy AGW accounts
* @param authorized bool - Whether the new deployer is authorized to deploy AGW accounts
*/
function setDeployer(address deployer, bool authorized) external onlyOwner {
authorizedDeployers[deployer] = authorized;
emit DeployerAuthorized(deployer, authorized);
}
/**
* @notice Changes the implementation contract address
* @param newImplementation address - Address of the new implementation contract
*/
function changeImplementation(address newImplementation, bytes4 newInitializerSelector) external onlyOwner {
implementationAddress = newImplementation;
initializerSelector = newInitializerSelector;
emit ImplementationChanged(newImplementation);
}
/**
* @notice Changes the registry contract address
* @param newRegistry address - Address of the new registry contract
*/
function changeRegistry(address newRegistry) external onlyOwner {
registry = newRegistry;
emit RegistryChanged(newRegistry);
}
/**
* @notice Returns the address of the AGW account that would be created with the given salt
* @dev If the account already exists, it returns the existing account address
* @param salt bytes32 - Salt to be used for the account creation
* @return accountAddress address - Address of the AGW account that would be created with the given salt
*/
function getAddressForSalt(bytes32 salt) external view returns (address accountAddress) {
// Check if the account is already deployed
accountAddress = saltToAccount[salt];
if (accountAddress == address(0)) {
// If not, get the deterministic account address for the current implementation
accountAddress = IContractDeployer(DEPLOYER_SYSTEM_CONTRACT).getNewAddressCreate2(
address(this),
proxyBytecodeHash,
salt,
abi.encode(implementationAddress)
);
}
}
/**
* @notice Returns the address of the AGW account that would be created with the given salt and implementation
* @param salt bytes32 - Salt to be used for the account creation
* @param _implementation address - Address of the implementation contract
* @return accountAddress address - Address of the AGW account that would be created with the given salt and implementation
*/
function getAddressForSaltAndImplementation(
bytes32 salt,
address _implementation
) external view returns (address accountAddress) {
accountAddress = IContractDeployer(DEPLOYER_SYSTEM_CONTRACT).getNewAddressCreate2(
address(this),
proxyBytecodeHash,
salt,
abi.encode(_implementation)
);
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {ERC165Checker} from '@openzeppelin/contracts/utils/introspection/ERC165Checker.sol';
import {ExcessivelySafeCall} from '@nomad-xyz/excessively-safe-call/src/ExcessivelySafeCall.sol';
import {AGWStorage} from '../libraries/AGWStorage.sol';
import {Auth} from '../auth/Auth.sol';
import {AddressLinkedList} from '../libraries/LinkedList.sol';
import {Errors} from '../libraries/Errors.sol';
import {IModule} from '../interfaces/IModule.sol';
import {IInitable} from '../interfaces/IInitable.sol';
import {IAGWAccount} from '../interfaces/IAGWAccount.sol';
import {IModuleManager} from '../interfaces/IModuleManager.sol';
/**
* @title Manager contract for modules
* @notice Abstract contract for managing the enabled modules of the account
* @dev Module addresses are stored in a linked list
* @author https://getclave.io
*/
abstract contract ModuleManager is IModuleManager, Auth {
// Helper library for address to address mappings
using AddressLinkedList for mapping(address => address);
// Interface helper library
using ERC165Checker for address;
// Low level calls helper library
using ExcessivelySafeCall for address;
/// @inheritdoc IModuleManager
function addModule(bytes calldata moduleAndData) external override onlySelfOrModule {
_addModule(moduleAndData);
}
/// @inheritdoc IModuleManager
function removeModule(address module) external override onlySelfOrModule {
_removeModule(module);
}
/// @inheritdoc IModuleManager
function executeFromModule(
address to,
uint256 value,
bytes memory data
) external override onlyModule {
if (to == address(this)) revert Errors.RECUSIVE_MODULE_CALL();
assembly {
let result := call(gas(), to, value, add(data, 0x20), mload(data), 0, 0)
if iszero(result) {
returndatacopy(0, 0, returndatasize())
revert(0, returndatasize())
}
}
}
/// @inheritdoc IModuleManager
function isModule(address addr) external view override returns (bool) {
return _isModule(addr);
}
/// @inheritdoc IModuleManager
function listModules() external view override returns (address[] memory moduleList) {
moduleList = _modulesLinkedList().list();
}
function _addModule(bytes calldata moduleAndData) internal {
if (moduleAndData.length < 20) {
revert Errors.EMPTY_MODULE_ADDRESS();
}
address moduleAddress = address(bytes20(moduleAndData[0:20]));
bytes calldata initData = moduleAndData[20:];
if (!_supportsModule(moduleAddress)) {
revert Errors.MODULE_ERC165_FAIL();
}
_modulesLinkedList().add(moduleAddress);
IModule(moduleAddress).init(initData);
emit AddModule(moduleAddress);
}
function _removeModule(address module) internal {
(bool success, ) = module.excessivelySafeCall(
gasleft(),
0,
0,
abi.encodeWithSelector(IInitable.disable.selector)
);
(success); // silence unused local variable warning
_modulesLinkedList().remove(module);
emit RemoveModule(module);
}
function _isModule(address addr) internal view override returns (bool) {
return _modulesLinkedList().exists(addr);
}
function _modulesLinkedList()
private
view
returns (mapping(address => address) storage modules)
{
modules = AGWStorage.layout().modules;
}
function _supportsModule(address module) internal view returns (bool) {
return module.supportsInterface(type(IModule).interfaceId);
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
import '@openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol';
/**
* Token callback handler.
* Handles supported tokens' callbacks, allowing account receiving these tokens.
*/
contract TokenCallbackHandler is IERC721Receiver, IERC1155Receiver {
function onERC721Received(
address,
address,
uint256,
bytes calldata
) external pure override returns (bytes4) {
return IERC721Receiver.onERC721Received.selector;
}
function onERC1155Received(
address,
address,
uint256,
uint256,
bytes calldata
) external pure override returns (bytes4) {
return IERC1155Receiver.onERC1155Received.selector;
}
function onERC1155BatchReceived(
address,
address,
uint256[] calldata,
uint256[] calldata,
bytes calldata
) external pure override returns (bytes4) {
return IERC1155Receiver.onERC1155BatchReceived.selector;
}
/// @dev functon visibility changed to public to allow overriding
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return
interfaceId == type(IERC721Receiver).interfaceId ||
interfaceId == type(IERC1155Receiver).interfaceId ||
interfaceId == type(IERC165).interfaceId;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {IERC1271} from '@openzeppelin/contracts/interfaces/IERC1271.sol';
import {SignatureDecoder} from '../libraries/SignatureDecoder.sol';
import {ValidationHandler} from './ValidationHandler.sol';
import {EIP712Upgradeable} from '@openzeppelin/contracts-upgradeable/utils/cryptography/EIP712Upgradeable.sol';
import {OperationType} from '../interfaces/IValidator.sol';
/**
* @title ERC1271Handler
* @notice Contract which provides ERC1271 signature validation
* @dev Forked from Clave for Abstract
* @author https://getclave.io
* @author https://abs.xyz
*/
abstract contract ERC1271Handler is
IERC1271,
EIP712Upgradeable,
ValidationHandler
{
struct AGWMessage {
bytes32 signedHash;
}
bytes32 constant _AGW_MESSAGE_TYPEHASH = keccak256('AGWMessage(bytes32 signedHash)');
bytes4 private constant _ERC1271_MAGIC = 0x1626ba7e;
function __ERC1271Handler_init() internal onlyInitializing {
__EIP712_init('AbstractGlobalWallet', '1.0.0');
}
/**
* @dev Should return whether the signature provided is valid for the provided data
* @param signedHash bytes32 - Hash of the data that is signed
* @param signatureAndValidator bytes calldata - Validator address concatenated to signature
* @return magicValue bytes4 - Magic value if the signature is valid, 0 otherwise
*/
function isValidSignature(
bytes32 signedHash,
bytes memory signatureAndValidator
) public view override returns (bytes4 magicValue) {
(bytes memory signature, address validator) = SignatureDecoder.decodeSignatureNoHookData(
signatureAndValidator
);
bytes32 eip712Hash = _hashTypedDataV4(_agwMessageHash(AGWMessage(signedHash)));
bool valid = _handleValidation(validator, OperationType.Signature, eip712Hash, signature);
magicValue = valid ? _ERC1271_MAGIC : bytes4(0);
}
/**
* @notice Returns the EIP-712 hash of the AGW message
* @param agwMessage AGWMessage calldata - The message containing signedHash
* @return bytes32 - EIP712 hash of the message
*/
function getEip712Hash(AGWMessage calldata agwMessage) external view returns (bytes32) {
return _hashTypedDataV4(_agwMessageHash(agwMessage));
}
/**
* @notice Returns the typehash for the AGW message struct
* @return bytes32 - AGW message typehash
*/
function agwMessageTypeHash() external pure returns (bytes32) {
return _AGW_MESSAGE_TYPEHASH;
}
function _agwMessageHash(AGWMessage memory agwMessage) internal pure returns (bytes32) {
return keccak256(abi.encode(_AGW_MESSAGE_TYPEHASH, agwMessage.signedHash));
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Errors} from '../libraries/Errors.sol';
import {Auth} from '../auth/Auth.sol';
import {IUpgradeManager} from '../interfaces/IUpgradeManager.sol';
/**
* @title Upgrade Manager
* @notice Abstract contract for managing the upgrade process of the account
* @author https://getclave.io
*/
abstract contract UpgradeManager is IUpgradeManager, Auth {
// keccak-256 of "eip1967.proxy.implementation" subtracted by 1
bytes32 private constant _IMPLEMENTATION_SLOT =
0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
/// @inheritdoc IUpgradeManager
function upgradeTo(address newImplementation) external override onlySelf {
address oldImplementation;
assembly {
oldImplementation := and(
sload(_IMPLEMENTATION_SLOT),
0xffffffffffffffffffffffffffffffffffffffff
)
}
if (oldImplementation == newImplementation) {
revert Errors.SAME_IMPLEMENTATION();
}
assembly {
sstore(_IMPLEMENTATION_SLOT, newImplementation)
}
emit Upgraded(oldImplementation, newImplementation);
}
/// @inheritdoc IUpgradeManager
function implementationAddress() external view override returns (address) {
address impl;
assembly {
impl := and(sload(_IMPLEMENTATION_SLOT), 0xffffffffffffffffffffffffffffffffffffffff)
}
return impl;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Errors} from '../libraries/Errors.sol';
library SignatureDecoder {
// Decode transaction.signature into signature, validator and hook data
function decodeSignature(
bytes calldata txSignature
) internal pure returns (bytes memory signature, address validator, bytes[] memory hookData) {
(signature, validator, hookData) = abi.decode(txSignature, (bytes, address, bytes[]));
}
// Decode transaction.signature into hook data
function decodeSignatureOnlyHookData(
bytes calldata txSignature
) internal pure returns (bytes[] memory hookData) {
(hookData) = abi.decode(txSignature, (bytes[]));
}
// Decode signature into signature and validator
function decodeSignatureNoHookData(
bytes memory signatureAndValidator
) internal pure returns (bytes memory signature, address validator) {
(signature, validator) = abi.decode(signatureAndValidator, (bytes, address));
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {ERC165Checker} from '@openzeppelin/contracts/utils/introspection/ERC165Checker.sol';
import {Transaction} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/TransactionHelper.sol';
import {ExcessivelySafeCall} from '@nomad-xyz/excessively-safe-call/src/ExcessivelySafeCall.sol';
import {Auth} from '../auth/Auth.sol';
import {AGWStorage} from '../libraries/AGWStorage.sol';
import {AddressLinkedList} from '../libraries/LinkedList.sol';
import {Errors} from '../libraries/Errors.sol';
import {IExecutionHook, IValidationHook} from '../interfaces/IHook.sol';
import {IInitable} from '../interfaces/IInitable.sol';
import {IHookManager} from '../interfaces/IHookManager.sol';
/**
* @title Manager contract for hooks
* @notice Abstract contract for managing the enabled hooks of the account
* @dev Hook addresses are stored in a linked list
* @author https://getclave.io
*/
abstract contract HookManager is IHookManager, Auth {
// Helper library for address to address mappings
using AddressLinkedList for mapping(address => address);
// Interface helper library
using ERC165Checker for address;
// Low level calls helper library
using ExcessivelySafeCall for address;
// Slot for execution hooks to store context
bytes32 private constant CONTEXT_KEY = keccak256('HookManager.context');
/// @inheritdoc IHookManager
function addHook(
bytes calldata hookAndData,
bool isValidation
) external override onlySelfOrModule {
_addHook(hookAndData, isValidation);
}
/// @inheritdoc IHookManager
function removeHook(address hook, bool isValidation) external override onlySelfOrModule {
_removeHook(hook, isValidation);
}
/// @inheritdoc IHookManager
function setHookData(bytes32 key, bytes calldata data) external override onlyHook {
if (key == CONTEXT_KEY) {
revert Errors.INVALID_KEY();
}
_hookDataStore()[msg.sender][key] = data;
}
/// @inheritdoc IHookManager
function getHookData(address hook, bytes32 key) external view override returns (bytes memory) {
return _hookDataStore()[hook][key];
}
/// @inheritdoc IHookManager
function isHook(address addr) external view override returns (bool) {
return _isHook(addr);
}
/// @inheritdoc IHookManager
function listHooks(
bool isValidation
) external view override returns (address[] memory hookList) {
if (isValidation) {
hookList = _validationHooksLinkedList().list();
} else {
hookList = _executionHooksLinkedList().list();
}
}
// Runs the validation hooks that are enabled by the account and returns true if none reverts
function runValidationHooks(
bytes32 signedHash,
Transaction calldata transaction,
bytes[] memory hookData
) internal returns (bool) {
mapping(address => address) storage validationHooks = _validationHooksLinkedList();
address cursor = validationHooks[AddressLinkedList.SENTINEL_ADDRESS];
uint256 idx = 0;
// Iterate through hooks
while (cursor > AddressLinkedList.SENTINEL_ADDRESS) {
// hookData array is out of bounds for the number of hooks
if (idx >= hookData.length) {
return false;
}
// Call it with corresponding hookData
bool success = _call(
cursor,
abi.encodeWithSelector(
IValidationHook.validationHook.selector,
signedHash,
transaction,
hookData[idx++]
)
);
if (!success) {
return false;
}
cursor = validationHooks[cursor];
}
// Ensure that hookData is not tampered with
if (hookData.length != idx) return false;
return true;
}
// Runs the execution hooks that are enabled by the account before and after _executeTransaction
modifier runExecutionHooks(Transaction calldata transaction) {
mapping(address => address) storage executionHooks = _executionHooksLinkedList();
address cursor = executionHooks[AddressLinkedList.SENTINEL_ADDRESS];
// Iterate through hooks
while (cursor > AddressLinkedList.SENTINEL_ADDRESS) {
// Call the preExecutionHook function with transaction struct
bytes memory context = IExecutionHook(cursor).preExecutionHook(transaction);
// Store returned data as context
_setContext(cursor, context);
cursor = executionHooks[cursor];
}
_;
cursor = executionHooks[AddressLinkedList.SENTINEL_ADDRESS];
// Iterate through hooks
while (cursor > AddressLinkedList.SENTINEL_ADDRESS) {
bytes memory context = _getContext(cursor);
if (context.length > 0) {
// Call the postExecutionHook function with stored context
IExecutionHook(cursor).postExecutionHook(context);
// Delete context
_deleteContext(cursor);
}
cursor = executionHooks[cursor];
}
}
function _addHook(bytes calldata hookAndData, bool isValidation) internal {
if (hookAndData.length < 20) {
revert Errors.EMPTY_HOOK_ADDRESS();
}
address hookAddress = address(bytes20(hookAndData[0:20]));
if (!_supportsHook(hookAddress, isValidation)) {
revert Errors.HOOK_ERC165_FAIL();
}
bytes calldata initData = hookAndData[20:];
if (isValidation) {
_validationHooksLinkedList().add(hookAddress);
} else {
_executionHooksLinkedList().add(hookAddress);
}
IInitable(hookAddress).init(initData);
emit AddHook(hookAddress);
}
function _removeHook(address hook, bool isValidation) internal {
if (isValidation) {
_validationHooksLinkedList().remove(hook);
} else {
_executionHooksLinkedList().remove(hook);
}
// if the hook removal occured during execution of hooks, the hook
// context will not be cleaned up during post execution so we need
// to delete it manually
_deleteContext(hook);
(bool success, ) = hook.excessivelySafeCall(
gasleft(),
0,
0,
abi.encodeWithSelector(IInitable.disable.selector)
);
(success); // silence unused local variable warning
emit RemoveHook(hook);
}
function _isHook(address addr) internal view override returns (bool) {
return
_validationHooksLinkedList().exists(addr) || _executionHooksLinkedList().exists(addr);
}
function _setContext(address hook, bytes memory context) private {
_hookDataStore()[hook][CONTEXT_KEY] = context;
}
function _deleteContext(address hook) private {
delete _hookDataStore()[hook][CONTEXT_KEY];
}
function _getContext(address hook) private view returns (bytes memory context) {
context = _hookDataStore()[hook][CONTEXT_KEY];
}
function _call(address target, bytes memory data) private returns (bool success) {
assembly ('memory-safe') {
success := call(gas(), target, 0, add(data, 0x20), mload(data), 0, 0)
}
}
function _validationHooksLinkedList()
private
view
returns (mapping(address => address) storage validationHooks)
{
validationHooks = AGWStorage.layout().validationHooks;
}
function _executionHooksLinkedList()
private
view
returns (mapping(address => address) storage executionHooks)
{
executionHooks = AGWStorage.layout().executionHooks;
}
function _hookDataStore()
private
view
returns (mapping(address => mapping(bytes32 => bytes)) storage hookDataStore)
{
hookDataStore = AGWStorage.layout().hookDataStore;
}
function _supportsHook(address hook, bool isValidation) internal view returns (bool) {
return
isValidation
? hook.supportsInterface(type(IValidationHook).interfaceId)
: hook.supportsInterface(type(IExecutionHook).interfaceId);
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
library Errors {
/*//////////////////////////////////////////////////////////////
AGW
//////////////////////////////////////////////////////////////*/
error INSUFFICIENT_FUNDS(); // 0xe7931438
error FEE_PAYMENT_FAILED(); // 0x3d40a3a3
error UNAUTHORIZED_OUTSIDE_TRANSACTION(); // 0xfc82da4e
error VALIDATION_HOOK_FAILED(); // 0x52c9d27a
/*//////////////////////////////////////////////////////////////
LINKED LIST
//////////////////////////////////////////////////////////////*/
error INVALID_PREV(); // 0x5a4c0eb3
// Bytes
error INVALID_BYTES(); // 0xb6dfaaff
error BYTES_ALREADY_EXISTS(); // 0xdf6cac6b
error BYTES_NOT_EXISTS(); // 0x689908a6
// Address
error INVALID_ADDRESS(); // 0x5963709b
error ADDRESS_ALREADY_EXISTS(); // 0xf2d4d191
error ADDRESS_NOT_EXISTS(); // 0xad6ab975
/*//////////////////////////////////////////////////////////////
OWNER MANAGER
//////////////////////////////////////////////////////////////*/
error EMPTY_OWNERS(); // 0xc957eb7e
error INVALID_PUBKEY_LENGTH(); // 0x04c4d8f7
/*//////////////////////////////////////////////////////////////
VALIDATOR MANAGER
//////////////////////////////////////////////////////////////*/
error EMPTY_VALIDATORS(); // 0xd7c64d89
error VALIDATOR_ERC165_FAIL(); // 0x5d5273ad
/*//////////////////////////////////////////////////////////////
UPGRADE MANAGER
//////////////////////////////////////////////////////////////*/
error SAME_IMPLEMENTATION(); // 0x5e741005
/*//////////////////////////////////////////////////////////////
HOOK MANAGER
//////////////////////////////////////////////////////////////*/
error EMPTY_HOOK_ADDRESS(); // 0x413348ae
error HOOK_ERC165_FAIL(); // 0x9f93f87d
error INVALID_KEY(); // 0xce7045bd
/*//////////////////////////////////////////////////////////////
MODULE MANAGER
//////////////////////////////////////////////////////////////*/
error EMPTY_MODULE_ADDRESS(); // 0x912fe2f2
error RECUSIVE_MODULE_CALL(); // 0x2cf7b9c8
error MODULE_ERC165_FAIL(); // 0xc1ad2a50
/*//////////////////////////////////////////////////////////////
AUTH
//////////////////////////////////////////////////////////////*/
error NOT_FROM_BOOTLOADER(); // 0x93887e3b
error NOT_FROM_MODULE(); // 0x574a805d
error NOT_FROM_HOOK(); // 0xd675a4f1
error NOT_FROM_SELF(); // 0xa70c28d1
error NOT_FROM_SELF_OR_MODULE(); // 0x22a1259f
/*//////////////////////////////////////////////////////////////
R1 VALIDATOR
//////////////////////////////////////////////////////////////*/
error INVALID_SIGNATURE(); // 0xa3402a38
/*//////////////////////////////////////////////////////////////
SOCIAL RECOVERY
//////////////////////////////////////////////////////////////*/
error INVALID_RECOVERY_CONFIG(); // 0xf774f439
error INVALID_RECOVERY_NONCE(); // 0x098c9f8e
error INVALID_GUARDIAN(); // 0x11a2a82b
error INVALID_GUARDIAN_SIGNATURE(); // 0xcc117c1c
error ZERO_ADDRESS_GUARDIAN(); // 0x6de9b401
error GUARDIANS_MUST_BE_SORTED(); // 0xc52b41f7
error RECOVERY_TIMELOCK(); // 0x1506ac5a
error RECOVERY_NOT_STARTED(); // 0xa6a4a3aa
error RECOVERY_NOT_INITED(); // 0xd0f6fdbf
error RECOVERY_IN_PROGRESS(); // 0x8daa42a9
error INSUFFICIENT_GUARDIANS(); // 0x7629075d
error ALREADY_INITED(); // 0xdb0c77c8
/*//////////////////////////////////////////////////////////////
FACTORY
//////////////////////////////////////////////////////////////*/
error DEPLOYMENT_FAILED(); // 0x0f02d218
error INITIALIZATION_FAILED(); // 0x5b101091
error INVALID_INITIALIZER(); // 0x350366d7
error INVALID_SALT(); // 0x8b3152e6
error ALREADY_CREATED(); // 0x26ebf2e8
/*//////////////////////////////////////////////////////////////
PAYMASTER
//////////////////////////////////////////////////////////////*/
error UNSUPPORTED_FLOW(); // 0xd721e389
error UNAUTHORIZED_WITHDRAW(); // 0x7809a0b4
error INVALID_TOKEN(); // 0xd0995cf2
error SHORT_PAYMASTER_INPUT(); // 0x48d170f6
error UNSUPPORTED_TOKEN(); // 0xce706f70
error LESS_ALLOWANCE_FOR_PAYMASTER(); // 0x11f7d13f
error FAILED_FEE_TRANSFER(); // 0xf316e09d
error INVALID_MARKUP(); // 0x4af7ffe3
error USER_LIMIT_REACHED(); // 0x07235346
error INVALID_USER_LIMIT(); // 0x2640fa41
error NOT_AGW_ACCOUNT(); // 0x1ae1d6fd
error EXCEEDS_MAX_SPONSORED_ETH(); // 0x3f379f40
/*//////////////////////////////////////////////////////////////
REGISTRY
//////////////////////////////////////////////////////////////*/
error NOT_FROM_FACTORY(); // 0x238438ed
error NOT_FROM_DEPLOYER(); // 0x83f090e3
/*//////////////////////////////////////////////////////////////
BatchCaller
//////////////////////////////////////////////////////////////*/
error ONLY_DELEGATECALL(); // 0x43d22ee9
error CALL_FAILED(); // 0x84aed38d
/*//////////////////////////////////////////////////////////////
INITABLE
//////////////////////////////////////////////////////////////*/
error MODULE_NOT_ADDED_CORRECTLY(); // 0xb66e8ec4
error MODULE_NOT_REMOVED_CORRECTLY(); // 0x680c8744
error MsgValueMismatch(uint256 actualValue, uint256 expectedValue);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {IERC165} from '@openzeppelin/contracts/utils/introspection/IERC165.sol';
enum OperationType {
Signature,
Transaction
}
/**
* @title secp256r1 ec keys' signature validator interface
* @author https://getclave.io
*/
interface IR1Validator is IERC165 {
/**
* @notice Allows to validate secp256r1 ec signatures
* @param signedHash bytes32 - hash of the data that is signed by the key
* @param signature bytes - signature
* @param pubKey bytes32[2] - public key coordinates array for the x and y values
* @return valid bool - validation result
*/
function validateSignature(
OperationType operationType,
bytes32 signedHash,
bytes calldata signature,
bytes32[2] calldata pubKey
) external view returns (bool valid);
}
/**
* @title secp256k1 ec keys' signature validator interface
* @author https://getclave.io
*/
interface IK1Validator is IERC165 {
/**
* @notice Allows to validate secp256k1 ec signatures
* @param signedHash bytes32 - hash of the transaction signed by the key
* @param signature bytes - signature
* @return signer address - recovered signer address
*/
function validateSignature(
OperationType operationType,
bytes32 signedHash,
bytes calldata signature
) external view returns (address signer);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;
import {SystemContractsCaller} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/SystemContractsCaller.sol';
import {EfficientCall} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/EfficientCall.sol';
import { DEPLOYER_SYSTEM_CONTRACT } from "@matterlabs/zksync-contracts/l2/system-contracts/Constants.sol";
import {Errors} from '../libraries/Errors.sol';
import {SelfAuth} from '../auth/SelfAuth.sol';
// Each call data for batches
struct Call {
address target; // Target contract address
bool allowFailure; // Whether to revert if the call fails
uint256 value; // Amount of ETH to send with call
bytes callData; // Calldata to send
}
/// @title BatchCaller
/// @notice Make multiple calls in a single transaction
abstract contract BatchCaller is SelfAuth {
/// @notice Make multiple calls, ensure success if required.
/// @dev The total Ether sent across all calls must be equal to `msg.value` to maintain the invariant
/// that `msg.value` + `tx.fee` is the maximum amount of Ether that can be spent on the transaction.
/// @param _calls Array of Call structs, each representing an individual external call to be made.
function batchCall(Call[] calldata _calls) external payable onlySelf {
uint256 totalValue;
uint256 len = _calls.length;
for (uint256 i = 0; i < len; ++i) {
totalValue += _calls[i].value;
bool success;
if (_calls[i].target == address(DEPLOYER_SYSTEM_CONTRACT)) {
// Note, that the deployer contract can only be called with a "systemCall" flag.
success = SystemContractsCaller.systemCall(
uint32(gasleft()),
_calls[i].target,
_calls[i].value,
_calls[i].callData
);
} else {
success = EfficientCall.rawCall(gasleft(), _calls[i].target, _calls[i].value, _calls[i].callData, false);
}
if (!_calls[i].allowFailure && !success) {
revert Errors.CALL_FAILED();
}
}
if (totalValue != msg.value) {
revert Errors.MsgValueMismatch(msg.value, totalValue);
}
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {IAccount} from '@matterlabs/zksync-contracts/l2/system-contracts/interfaces/IAccount.sol';
import {IERC1271} from '@openzeppelin/contracts/interfaces/IERC1271.sol';
import {IERC777Recipient} from '@openzeppelin/contracts/interfaces/IERC777Recipient.sol';
import {IERC721Receiver} from '@openzeppelin/contracts/interfaces/IERC721Receiver.sol';
import {IERC1155Receiver} from '@openzeppelin/contracts/interfaces/IERC1155Receiver.sol';
import {IHookManager} from './IHookManager.sol';
import {IModuleManager} from './IModuleManager.sol';
import {IOwnerManager} from './IOwnerManager.sol';
import {IUpgradeManager} from './IUpgradeManager.sol';
import {IValidatorManager} from './IValidatorManager.sol';
/**
* @title IAGWAccount
* @notice Interface for the AGW contract
* @dev Implementations of this interface are contracts that can be used as an AGW account
* @dev Forked from Clave for Abstract
* @author https://getclave.io
* @author https://abs.xyz
*/
interface IAGWAccount is
IERC1271,
IERC721Receiver,
IERC1155Receiver,
IHookManager,
IModuleManager,
IOwnerManager,
IValidatorManager,
IUpgradeManager,
IAccount
{
event FeePaid();
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./interfaces/IAccountCodeStorage.sol";
import "./interfaces/INonceHolder.sol";
import "./interfaces/IContractDeployer.sol";
import "./interfaces/IKnownCodesStorage.sol";
import "./interfaces/IImmutableSimulator.sol";
import "./interfaces/IEthToken.sol";
import "./interfaces/IL1Messenger.sol";
import "./interfaces/ISystemContext.sol";
import "./interfaces/IBytecodeCompressor.sol";
import "./BootloaderUtilities.sol";
/// @dev All the system contracts introduced by zkSync have their addresses
/// started from 2^15 in order to avoid collision with Ethereum precompiles.
uint160 constant SYSTEM_CONTRACTS_OFFSET = 0x8000; // 2^15
/// @dev All the system contracts must be located in the kernel space,
/// i.e. their addresses must be below 2^16.
uint160 constant MAX_SYSTEM_CONTRACT_ADDRESS = 0xffff; // 2^16 - 1
address constant ECRECOVER_SYSTEM_CONTRACT = address(0x01);
address constant SHA256_SYSTEM_CONTRACT = address(0x02);
/// @dev The current maximum deployed precompile address.
/// Note: currently only two precompiles are deployed:
/// 0x01 - ecrecover
/// 0x02 - sha256
/// Important! So the constant should be updated if more precompiles are deployed.
uint256 constant CURRENT_MAX_PRECOMPILE_ADDRESS = uint256(uint160(SHA256_SYSTEM_CONTRACT));
address payable constant BOOTLOADER_FORMAL_ADDRESS = payable(address(SYSTEM_CONTRACTS_OFFSET + 0x01));
IAccountCodeStorage constant ACCOUNT_CODE_STORAGE_SYSTEM_CONTRACT = IAccountCodeStorage(
address(SYSTEM_CONTRACTS_OFFSET + 0x02)
);
INonceHolder constant NONCE_HOLDER_SYSTEM_CONTRACT = INonceHolder(address(SYSTEM_CONTRACTS_OFFSET + 0x03));
IKnownCodesStorage constant KNOWN_CODE_STORAGE_CONTRACT = IKnownCodesStorage(address(SYSTEM_CONTRACTS_OFFSET + 0x04));
IImmutableSimulator constant IMMUTABLE_SIMULATOR_SYSTEM_CONTRACT = IImmutableSimulator(
address(SYSTEM_CONTRACTS_OFFSET + 0x05)
);
IContractDeployer constant DEPLOYER_SYSTEM_CONTRACT = IContractDeployer(address(SYSTEM_CONTRACTS_OFFSET + 0x06));
// A contract that is allowed to deploy any codehash
// on any address. To be used only during an upgrade.
address constant FORCE_DEPLOYER = address(SYSTEM_CONTRACTS_OFFSET + 0x07);
IL1Messenger constant L1_MESSENGER_CONTRACT = IL1Messenger(address(SYSTEM_CONTRACTS_OFFSET + 0x08));
address constant MSG_VALUE_SYSTEM_CONTRACT = address(SYSTEM_CONTRACTS_OFFSET + 0x09);
IEthToken constant ETH_TOKEN_SYSTEM_CONTRACT = IEthToken(address(SYSTEM_CONTRACTS_OFFSET + 0x0a));
address constant KECCAK256_SYSTEM_CONTRACT = address(SYSTEM_CONTRACTS_OFFSET + 0x10);
ISystemContext constant SYSTEM_CONTEXT_CONTRACT = ISystemContext(payable(address(SYSTEM_CONTRACTS_OFFSET + 0x0b)));
BootloaderUtilities constant BOOTLOADER_UTILITIES = BootloaderUtilities(address(SYSTEM_CONTRACTS_OFFSET + 0x0c));
address constant EVENT_WRITER_CONTRACT = address(SYSTEM_CONTRACTS_OFFSET + 0x0d);
IBytecodeCompressor constant BYTECODE_COMPRESSOR_CONTRACT = IBytecodeCompressor(
address(SYSTEM_CONTRACTS_OFFSET + 0x0e)
);
/// @dev If the bitwise AND of the extraAbi[2] param when calling the MSG_VALUE_SIMULATOR
/// is non-zero, the call will be assumed to be a system one.
uint256 constant MSG_VALUE_SIMULATOR_IS_SYSTEM_BIT = 1;
/// @dev The maximal msg.value that context can have
uint256 constant MAX_MSG_VALUE = 2 ** 128 - 1;
/// @dev Prefix used during derivation of account addresses using CREATE2
/// @dev keccak256("zksyncCreate2")
bytes32 constant CREATE2_PREFIX = 0x2020dba91b30cc0006188af794c2fb30dd8520db7e2c088b7fc7c103c00ca494;
/// @dev Prefix used during derivation of account addresses using CREATE
/// @dev keccak256("zksyncCreate")
bytes32 constant CREATE_PREFIX = 0x63bae3a9951d38e8a3fbb7b70909afc1200610fc5bc55ade242f815974674f23;// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../libraries/TransactionHelper.sol";
bytes4 constant ACCOUNT_VALIDATION_SUCCESS_MAGIC = IAccount.validateTransaction.selector;
interface IAccount {
/// @notice Called by the bootloader to validate that an account agrees to process the transaction
/// (and potentially pay for it).
/// @param _txHash The hash of the transaction to be used in the explorer
/// @param _suggestedSignedHash The hash of the transaction is signed by EOAs
/// @param _transaction The transaction itself
/// @return magic The magic value that should be equal to the signature of this function
/// if the user agrees to proceed with the transaction.
/// @dev The developer should strive to preserve as many steps as possible both for valid
/// and invalid transactions as this very method is also used during the gas fee estimation
/// (without some of the necessary data, e.g. signature).
function validateTransaction(
bytes32 _txHash,
bytes32 _suggestedSignedHash,
Transaction calldata _transaction
) external payable returns (bytes4 magic);
function executeTransaction(
bytes32 _txHash,
bytes32 _suggestedSignedHash,
Transaction calldata _transaction
) external payable;
// There is no point in providing possible signed hash in the `executeTransactionFromOutside` method,
// since it typically should not be trusted.
function executeTransactionFromOutside(Transaction calldata _transaction) external payable;
function payForTransaction(
bytes32 _txHash,
bytes32 _suggestedSignedHash,
Transaction calldata _transaction
) external payable;
function prepareForPaymaster(
bytes32 _txHash,
bytes32 _possibleSignedHash,
Transaction calldata _transaction
) external payable;
}// SPDX-License-Identifier: MIT OR Apache-2.0
pragma solidity ^0.8.0;
import "./SystemContractHelper.sol";
import "./Utils.sol";
import {SHA256_SYSTEM_CONTRACT, KECCAK256_SYSTEM_CONTRACT} from "../Constants.sol";
/**
* @author Matter Labs
* @notice This library is used to perform ultra-efficient calls using zkEVM-specific features.
* @dev EVM calls always accept a memory slice as input and return a memory slice as output.
* Therefore, even if the user has a ready-made calldata slice, they still need to copy it to memory
* before calling. This is especially inefficient for large inputs (proxies, multi-calls, etc.).
* In turn, zkEVM operates over a fat pointer, which is a set of (memory page, offset, start, length) in the memory/calldata/returndata.
* This allows forwarding the calldata slice as is, without copying it to memory.
* @dev Fat pointer is not just an integer, it is an extended data type supported on the VM level.
* zkEVM creates the wellformed fat pointers for all the calldata/returndata regions, later
* the contract may manipulate the already created fat pointers to forward a slice of the data, but not
* to create new fat pointers!
* @dev The allowed operation on fat pointers are:
* 1. `ptr.add` - Transforms `ptr.offset` into `ptr.offset + u32(_value)`. If overflow happens then it panics.
* 2. `ptr.sub` - Transforms `ptr.offset` into `ptr.offset - u32(_value)`. If underflow happens then it panics.
* 3. `ptr.pack` - Do the concatenation between the lowest 128 bits of the pointer itself and the highest 128 bits of `_value`. It is typically used to prepare the ABI for external calls.
* 4. `ptr.shrink` - Transforms `ptr.length` into `ptr.length - u32(_shrink)`. If underflow happens then it panics.
* @dev The call opcodes accept the fat pointer and change it to its canonical form before passing it to the child call
* 1. `ptr.start` is transformed into `ptr.offset + ptr.start`
* 2. `ptr.length` is transformed into `ptr.length - ptr.offset`
* 3. `ptr.offset` is transformed into `0`
*/
library EfficientCall {
/// @notice Call the `keccak256` without copying calldata to memory.
/// @param _data The preimage data.
/// @return The `keccak256` hash.
function keccak(bytes calldata _data) internal view returns (bytes32) {
bytes memory returnData = staticCall(gasleft(), KECCAK256_SYSTEM_CONTRACT, _data);
require(returnData.length == 32, "keccak256 returned invalid data");
return bytes32(returnData);
}
/// @notice Call the `sha256` precompile without copying calldata to memory.
/// @param _data The preimage data.
/// @return The `sha256` hash.
function sha(bytes calldata _data) internal view returns (bytes32) {
bytes memory returnData = staticCall(gasleft(), SHA256_SYSTEM_CONTRACT, _data);
require(returnData.length == 32, "sha returned invalid data");
return bytes32(returnData);
}
/// @notice Perform a `call` without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _value The `msg.value` to send.
/// @param _data The calldata to use for the call.
/// @param _isSystem Whether the call should contain the `isSystem` flag.
/// @return returnData The copied to memory return data.
function call(
uint256 _gas,
address _address,
uint256 _value,
bytes calldata _data,
bool _isSystem
) internal returns (bytes memory returnData) {
bool success = rawCall(_gas, _address, _value, _data, _isSystem);
returnData = _verifyCallResult(success);
}
/// @notice Perform a `staticCall` without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _data The calldata to use for the call.
/// @return returnData The copied to memory return data.
function staticCall(
uint256 _gas,
address _address,
bytes calldata _data
) internal view returns (bytes memory returnData) {
bool success = rawStaticCall(_gas, _address, _data);
returnData = _verifyCallResult(success);
}
/// @notice Perform a `delegateCall` without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _data The calldata to use for the call.
/// @return returnData The copied to memory return data.
function delegateCall(
uint256 _gas,
address _address,
bytes calldata _data
) internal returns (bytes memory returnData) {
bool success = rawDelegateCall(_gas, _address, _data);
returnData = _verifyCallResult(success);
}
/// @notice Perform a `mimicCall` (a call with custom msg.sender) without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _data The calldata to use for the call.
/// @param _whoToMimic The `msg.sender` for the next call.
/// @param _isConstructor Whether the call should contain the `isConstructor` flag.
/// @param _isSystem Whether the call should contain the `isSystem` flag.
/// @return returnData The copied to memory return data.
function mimicCall(
uint256 _gas,
address _address,
bytes calldata _data,
address _whoToMimic,
bool _isConstructor,
bool _isSystem
) internal returns (bytes memory returnData) {
bool success = rawMimicCall(_gas, _address, _data, _whoToMimic, _isConstructor, _isSystem);
returnData = _verifyCallResult(success);
}
/// @notice Perform a `call` without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _value The `msg.value` to send.
/// @param _data The calldata to use for the call.
/// @param _isSystem Whether the call should contain the `isSystem` flag.
/// @return success whether the call was successful.
function rawCall(
uint256 _gas,
address _address,
uint256 _value,
bytes calldata _data,
bool _isSystem
) internal returns (bool success) {
if (_value == 0) {
_loadFarCallABIIntoActivePtr(_gas, _data, false, _isSystem);
address callAddr = RAW_FAR_CALL_BY_REF_CALL_ADDRESS;
assembly {
success := call(_address, callAddr, 0, 0, 0xFFFF, 0, 0)
}
} else {
_loadFarCallABIIntoActivePtr(_gas, _data, false, true);
// If there is provided `msg.value` call the `MsgValueSimulator` to forward ether.
address msgValueSimulator = MSG_VALUE_SYSTEM_CONTRACT;
address callAddr = SYSTEM_CALL_BY_REF_CALL_ADDRESS;
// We need to supply the mask to the MsgValueSimulator to denote
// that the call should be a system one.
uint256 forwardMask = _isSystem ? MSG_VALUE_SIMULATOR_IS_SYSTEM_BIT : 0;
assembly {
success := call(msgValueSimulator, callAddr, _value, _address, 0xFFFF, forwardMask, 0)
}
}
}
/// @notice Perform a `staticCall` without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _data The calldata to use for the call.
/// @return success whether the call was successful.
function rawStaticCall(uint256 _gas, address _address, bytes calldata _data) internal view returns (bool success) {
_loadFarCallABIIntoActivePtr(_gas, _data, false, false);
address callAddr = RAW_FAR_CALL_BY_REF_CALL_ADDRESS;
assembly {
success := staticcall(_address, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Perform a `delegatecall` without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _data The calldata to use for the call.
/// @return success whether the call was successful.
function rawDelegateCall(uint256 _gas, address _address, bytes calldata _data) internal returns (bool success) {
_loadFarCallABIIntoActivePtr(_gas, _data, false, false);
address callAddr = RAW_FAR_CALL_BY_REF_CALL_ADDRESS;
assembly {
success := delegatecall(_address, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Perform a `mimicCall` (call with custom msg.sender) without copying calldata to memory.
/// @param _gas The gas to use for the call.
/// @param _address The address to call.
/// @param _data The calldata to use for the call.
/// @param _whoToMimic The `msg.sender` for the next call.
/// @param _isConstructor Whether the call should contain the `isConstructor` flag.
/// @param _isSystem Whether the call should contain the `isSystem` flag.
/// @return success whether the call was successful.
/// @dev If called not in kernel mode, it will result in a revert (enforced by the VM)
function rawMimicCall(
uint256 _gas,
address _address,
bytes calldata _data,
address _whoToMimic,
bool _isConstructor,
bool _isSystem
) internal returns (bool success) {
_loadFarCallABIIntoActivePtr(_gas, _data, _isConstructor, _isSystem);
address callAddr = MIMIC_CALL_BY_REF_CALL_ADDRESS;
uint256 cleanupMask = ADDRESS_MASK;
assembly {
// Clearing values before usage in assembly, since Solidity
// doesn't do it by default
_whoToMimic := and(_whoToMimic, cleanupMask)
success := call(_address, callAddr, 0, 0, _whoToMimic, 0, 0)
}
}
/// @dev Verify that a low-level call was successful, and revert if it wasn't, by bubbling the revert reason.
/// @param _success Whether the call was successful.
/// @return returnData The copied to memory return data.
function _verifyCallResult(bool _success) private pure returns (bytes memory returnData) {
if (_success) {
uint256 size;
assembly {
size := returndatasize()
}
returnData = new bytes(size);
assembly {
returndatacopy(add(returnData, 0x20), 0, size)
}
} else {
propagateRevert();
}
}
/// @dev Propagate the revert reason from the current call to the caller.
function propagateRevert() internal pure {
assembly {
let size := returndatasize()
returndatacopy(0, 0, size)
revert(0, size)
}
}
/// @dev Load the far call ABI into active ptr, that will be used for the next call by reference.
/// @param _gas The gas to be passed to the call.
/// @param _data The calldata to be passed to the call.
/// @param _isConstructor Whether the call is a constructor call.
/// @param _isSystem Whether the call is a system call.
function _loadFarCallABIIntoActivePtr(
uint256 _gas,
bytes calldata _data,
bool _isConstructor,
bool _isSystem
) private view {
SystemContractHelper.loadCalldataIntoActivePtr();
// Currently, zkEVM considers the pointer valid if(ptr.offset < ptr.length || (ptr.length == 0 && ptr.offset == 0)), otherwise panics.
// So, if the data is empty we need to make the `ptr.length = ptr.offset = 0`, otherwise follow standard logic.
if (_data.length == 0) {
// Safe to cast, offset is never bigger than `type(uint32).max`
SystemContractHelper.ptrShrinkIntoActive(uint32(msg.data.length));
} else {
uint256 dataOffset;
assembly {
dataOffset := _data.offset
}
// Safe to cast, offset is never bigger than `type(uint32).max`
SystemContractHelper.ptrAddIntoActive(uint32(dataOffset));
// Safe to cast, `data.length` is never bigger than `type(uint32).max`
uint32 shrinkTo = uint32(msg.data.length - (_data.length + dataOffset));
SystemContractHelper.ptrShrinkIntoActive(shrinkTo);
}
uint32 gas = Utils.safeCastToU32(_gas);
uint256 farCallAbi = SystemContractsCaller.getFarCallABIWithEmptyFatPointer(
gas,
// Only rollup is supported for now
0,
CalldataForwardingMode.ForwardFatPointer,
_isConstructor,
_isSystem
);
SystemContractHelper.ptrPackIntoActivePtr(farCallAbi);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8;
import {MSG_VALUE_SYSTEM_CONTRACT, MSG_VALUE_SIMULATOR_IS_SYSTEM_BIT} from "../Constants.sol";
import "./Utils.sol";
// Addresses used for the compiler to be replaced with the
// zkSync-specific opcodes during the compilation.
// IMPORTANT: these are just compile-time constants and are used
// only if used in-place by Yul optimizer.
address constant TO_L1_CALL_ADDRESS = address((1 << 16) - 1);
address constant CODE_ADDRESS_CALL_ADDRESS = address((1 << 16) - 2);
address constant PRECOMPILE_CALL_ADDRESS = address((1 << 16) - 3);
address constant META_CALL_ADDRESS = address((1 << 16) - 4);
address constant MIMIC_CALL_CALL_ADDRESS = address((1 << 16) - 5);
address constant SYSTEM_MIMIC_CALL_CALL_ADDRESS = address((1 << 16) - 6);
address constant MIMIC_CALL_BY_REF_CALL_ADDRESS = address((1 << 16) - 7);
address constant SYSTEM_MIMIC_CALL_BY_REF_CALL_ADDRESS = address((1 << 16) - 8);
address constant RAW_FAR_CALL_CALL_ADDRESS = address((1 << 16) - 9);
address constant RAW_FAR_CALL_BY_REF_CALL_ADDRESS = address((1 << 16) - 10);
address constant SYSTEM_CALL_CALL_ADDRESS = address((1 << 16) - 11);
address constant SYSTEM_CALL_BY_REF_CALL_ADDRESS = address((1 << 16) - 12);
address constant SET_CONTEXT_VALUE_CALL_ADDRESS = address((1 << 16) - 13);
address constant SET_PUBDATA_PRICE_CALL_ADDRESS = address((1 << 16) - 14);
address constant INCREMENT_TX_COUNTER_CALL_ADDRESS = address((1 << 16) - 15);
address constant PTR_CALLDATA_CALL_ADDRESS = address((1 << 16) - 16);
address constant CALLFLAGS_CALL_ADDRESS = address((1 << 16) - 17);
address constant PTR_RETURNDATA_CALL_ADDRESS = address((1 << 16) - 18);
address constant EVENT_INITIALIZE_ADDRESS = address((1 << 16) - 19);
address constant EVENT_WRITE_ADDRESS = address((1 << 16) - 20);
address constant LOAD_CALLDATA_INTO_ACTIVE_PTR_CALL_ADDRESS = address((1 << 16) - 21);
address constant LOAD_LATEST_RETURNDATA_INTO_ACTIVE_PTR_CALL_ADDRESS = address((1 << 16) - 22);
address constant PTR_ADD_INTO_ACTIVE_CALL_ADDRESS = address((1 << 16) - 23);
address constant PTR_SHRINK_INTO_ACTIVE_CALL_ADDRESS = address((1 << 16) - 24);
address constant PTR_PACK_INTO_ACTIVE_CALL_ADDRESS = address((1 << 16) - 25);
address constant MULTIPLICATION_HIGH_ADDRESS = address((1 << 16) - 26);
address constant GET_EXTRA_ABI_DATA_ADDRESS = address((1 << 16) - 27);
// All the offsets are in bits
uint256 constant META_GAS_PER_PUBDATA_BYTE_OFFSET = 0 * 8;
uint256 constant META_HEAP_SIZE_OFFSET = 8 * 8;
uint256 constant META_AUX_HEAP_SIZE_OFFSET = 12 * 8;
uint256 constant META_SHARD_ID_OFFSET = 28 * 8;
uint256 constant META_CALLER_SHARD_ID_OFFSET = 29 * 8;
uint256 constant META_CODE_SHARD_ID_OFFSET = 30 * 8;
/// @notice The way to forward the calldata:
/// - Use the current heap (i.e. the same as on EVM).
/// - Use the auxiliary heap.
/// - Forward via a pointer
/// @dev Note, that currently, users do not have access to the auxiliary
/// heap and so the only type of forwarding that will be used by the users
/// are UseHeap and ForwardFatPointer for forwarding a slice of the current calldata
/// to the next call.
enum CalldataForwardingMode {
UseHeap,
ForwardFatPointer,
UseAuxHeap
}
/**
* @author Matter Labs
* @notice A library that allows calling contracts with the `isSystem` flag.
* @dev It is needed to call ContractDeployer and NonceHolder.
*/
library SystemContractsCaller {
/// @notice Makes a call with the `isSystem` flag.
/// @param gasLimit The gas limit for the call.
/// @param to The address to call.
/// @param value The value to pass with the transaction.
/// @param data The calldata.
/// @return success Whether the transaction has been successful.
/// @dev Note, that the `isSystem` flag can only be set when calling system contracts.
function systemCall(uint32 gasLimit, address to, uint256 value, bytes memory data) internal returns (bool success) {
address callAddr = SYSTEM_CALL_CALL_ADDRESS;
uint32 dataStart;
assembly {
dataStart := add(data, 0x20)
}
uint32 dataLength = uint32(Utils.safeCastToU32(data.length));
uint256 farCallAbi = SystemContractsCaller.getFarCallABI(
0,
0,
dataStart,
dataLength,
gasLimit,
// Only rollup is supported for now
0,
CalldataForwardingMode.UseHeap,
false,
true
);
if (value == 0) {
// Doing the system call directly
assembly {
success := call(to, callAddr, 0, 0, farCallAbi, 0, 0)
}
} else {
address msgValueSimulator = MSG_VALUE_SYSTEM_CONTRACT;
// We need to supply the mask to the MsgValueSimulator to denote
// that the call should be a system one.
uint256 forwardMask = MSG_VALUE_SIMULATOR_IS_SYSTEM_BIT;
assembly {
success := call(msgValueSimulator, callAddr, value, to, farCallAbi, forwardMask, 0)
}
}
}
/// @notice Makes a call with the `isSystem` flag.
/// @param gasLimit The gas limit for the call.
/// @param to The address to call.
/// @param value The value to pass with the transaction.
/// @param data The calldata.
/// @return success Whether the transaction has been successful.
/// @return returnData The returndata of the transaction (revert reason in case the transaction has failed).
/// @dev Note, that the `isSystem` flag can only be set when calling system contracts.
function systemCallWithReturndata(
uint32 gasLimit,
address to,
uint128 value,
bytes memory data
) internal returns (bool success, bytes memory returnData) {
success = systemCall(gasLimit, to, value, data);
uint256 size;
assembly {
size := returndatasize()
}
returnData = new bytes(size);
assembly {
returndatacopy(add(returnData, 0x20), 0, size)
}
}
/// @notice Makes a call with the `isSystem` flag.
/// @param gasLimit The gas limit for the call.
/// @param to The address to call.
/// @param value The value to pass with the transaction.
/// @param data The calldata.
/// @return returnData The returndata of the transaction. In case the transaction reverts, the error
/// bubbles up to the parent frame.
/// @dev Note, that the `isSystem` flag can only be set when calling system contracts.
function systemCallWithPropagatedRevert(
uint32 gasLimit,
address to,
uint128 value,
bytes memory data
) internal returns (bytes memory returnData) {
bool success;
(success, returnData) = systemCallWithReturndata(gasLimit, to, value, data);
if (!success) {
assembly {
let size := mload(returnData)
revert(add(returnData, 0x20), size)
}
}
}
/// @notice Calculates the packed representation of the FarCallABI.
/// @param dataOffset Calldata offset in memory. Provide 0 unless using custom pointer.
/// @param memoryPage Memory page to use. Provide 0 unless using custom pointer.
/// @param dataStart The start of the calldata slice. Provide the offset in memory
/// if not using custom pointer.
/// @param dataLength The calldata length. Provide the length of the calldata in bytes
/// unless using custom pointer.
/// @param gasPassed The gas to pass with the call.
/// @param shardId Of the account to call. Currently only 0 is supported.
/// @param forwardingMode The forwarding mode to use:
/// - provide CalldataForwardingMode.UseHeap when using your current memory
/// - provide CalldataForwardingMode.ForwardFatPointer when using custom pointer.
/// @param isConstructorCall Whether the call will be a call to the constructor
/// (ignored when the caller is not a system contract).
/// @param isSystemCall Whether the call will have the `isSystem` flag.
/// @return farCallAbi The far call ABI.
/// @dev The `FarCallABI` has the following structure:
/// pub struct FarCallABI {
/// pub memory_quasi_fat_pointer: FatPointer,
/// pub gas_passed: u32,
/// pub shard_id: u8,
/// pub forwarding_mode: FarCallForwardPageType,
/// pub constructor_call: bool,
/// pub to_system: bool,
/// }
///
/// The FatPointer struct:
///
/// pub struct FatPointer {
/// pub offset: u32, // offset relative to `start`
/// pub memory_page: u32, // memory page where slice is located
/// pub start: u32, // absolute start of the slice
/// pub length: u32, // length of the slice
/// }
///
/// @dev Note, that the actual layout is the following:
///
/// [0..32) bits -- the calldata offset
/// [32..64) bits -- the memory page to use. Can be left blank in most of the cases.
/// [64..96) bits -- the absolute start of the slice
/// [96..128) bits -- the length of the slice.
/// [128..192) bits -- empty bits.
/// [192..224) bits -- gasPassed.
/// [224..232) bits -- forwarding_mode
/// [232..240) bits -- shard id.
/// [240..248) bits -- constructor call flag
/// [248..256] bits -- system call flag
function getFarCallABI(
uint32 dataOffset,
uint32 memoryPage,
uint32 dataStart,
uint32 dataLength,
uint32 gasPassed,
uint8 shardId,
CalldataForwardingMode forwardingMode,
bool isConstructorCall,
bool isSystemCall
) internal pure returns (uint256 farCallAbi) {
// Fill in the call parameter fields
farCallAbi = getFarCallABIWithEmptyFatPointer(
gasPassed,
shardId,
forwardingMode,
isConstructorCall,
isSystemCall
);
// Fill in the fat pointer fields
farCallAbi |= dataOffset;
farCallAbi |= (uint256(memoryPage) << 32);
farCallAbi |= (uint256(dataStart) << 64);
farCallAbi |= (uint256(dataLength) << 96);
}
/// @notice Calculates the packed representation of the FarCallABI with zero fat pointer fields.
/// @param gasPassed The gas to pass with the call.
/// @param shardId Of the account to call. Currently only 0 is supported.
/// @param forwardingMode The forwarding mode to use:
/// - provide CalldataForwardingMode.UseHeap when using your current memory
/// - provide CalldataForwardingMode.ForwardFatPointer when using custom pointer.
/// @param isConstructorCall Whether the call will be a call to the constructor
/// (ignored when the caller is not a system contract).
/// @param isSystemCall Whether the call will have the `isSystem` flag.
/// @return farCallAbiWithEmptyFatPtr The far call ABI with zero fat pointer fields.
function getFarCallABIWithEmptyFatPointer(
uint32 gasPassed,
uint8 shardId,
CalldataForwardingMode forwardingMode,
bool isConstructorCall,
bool isSystemCall
) internal pure returns (uint256 farCallAbiWithEmptyFatPtr) {
farCallAbiWithEmptyFatPtr |= (uint256(gasPassed) << 192);
farCallAbiWithEmptyFatPtr |= (uint256(forwardingMode) << 224);
farCallAbiWithEmptyFatPtr |= (uint256(shardId) << 232);
if (isConstructorCall) {
farCallAbiWithEmptyFatPtr |= (1 << 240);
}
if (isSystemCall) {
farCallAbiWithEmptyFatPtr |= (1 << 248);
}
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.8.0;
import "./EfficientCall.sol";
/**
* @author Matter Labs
* @dev Common utilities used in zkSync system contracts
*/
library Utils {
/// @dev Bit mask of bytecode hash "isConstructor" marker
bytes32 constant IS_CONSTRUCTOR_BYTECODE_HASH_BIT_MASK =
0x00ff000000000000000000000000000000000000000000000000000000000000;
/// @dev Bit mask to set the "isConstructor" marker in the bytecode hash
bytes32 constant SET_IS_CONSTRUCTOR_MARKER_BIT_MASK =
0x0001000000000000000000000000000000000000000000000000000000000000;
function safeCastToU128(uint256 _x) internal pure returns (uint128) {
require(_x <= type(uint128).max, "Overflow");
return uint128(_x);
}
function safeCastToU32(uint256 _x) internal pure returns (uint32) {
require(_x <= type(uint32).max, "Overflow");
return uint32(_x);
}
function safeCastToU24(uint256 _x) internal pure returns (uint24) {
require(_x <= type(uint24).max, "Overflow");
return uint24(_x);
}
/// @return codeLength The bytecode length in bytes
function bytecodeLenInBytes(bytes32 _bytecodeHash) internal pure returns (uint256 codeLength) {
codeLength = bytecodeLenInWords(_bytecodeHash) << 5; // _bytecodeHash * 32
}
/// @return codeLengthInWords The bytecode length in machine words
function bytecodeLenInWords(bytes32 _bytecodeHash) internal pure returns (uint256 codeLengthInWords) {
unchecked {
codeLengthInWords = uint256(uint8(_bytecodeHash[2])) * 256 + uint256(uint8(_bytecodeHash[3]));
}
}
/// @notice Denotes whether bytecode hash corresponds to a contract that already constructed
function isContractConstructed(bytes32 _bytecodeHash) internal pure returns (bool) {
return _bytecodeHash[1] == 0x00;
}
/// @notice Denotes whether bytecode hash corresponds to a contract that is on constructor or has already been constructed
function isContractConstructing(bytes32 _bytecodeHash) internal pure returns (bool) {
return _bytecodeHash[1] == 0x01;
}
/// @notice Sets "isConstructor" flag to TRUE for the bytecode hash
/// @param _bytecodeHash The bytecode hash for which it is needed to set the constructing flag
/// @return The bytecode hash with "isConstructor" flag set to TRUE
function constructingBytecodeHash(bytes32 _bytecodeHash) internal pure returns (bytes32) {
// Clear the "isConstructor" marker and set it to 0x01.
return constructedBytecodeHash(_bytecodeHash) | SET_IS_CONSTRUCTOR_MARKER_BIT_MASK;
}
/// @notice Sets "isConstructor" flag to FALSE for the bytecode hash
/// @param _bytecodeHash The bytecode hash for which it is needed to set the constructing flag
/// @return The bytecode hash with "isConstructor" flag set to FALSE
function constructedBytecodeHash(bytes32 _bytecodeHash) internal pure returns (bytes32) {
return _bytecodeHash & ~IS_CONSTRUCTOR_BYTECODE_HASH_BIT_MASK;
}
/// @notice Validate the bytecode format and calculate its hash.
/// @param _bytecode The bytecode to hash.
/// @return hashedBytecode The 32-byte hash of the bytecode.
/// Note: The function reverts the execution if the bytecode has non expected format:
/// - Bytecode bytes length is not a multiple of 32
/// - Bytecode bytes length is not less than 2^21 bytes (2^16 words)
/// - Bytecode words length is not odd
function hashL2Bytecode(bytes calldata _bytecode) internal view returns (bytes32 hashedBytecode) {
// Note that the length of the bytecode must be provided in 32-byte words.
require(_bytecode.length % 32 == 0, "po");
uint256 bytecodeLenInWords = _bytecode.length / 32;
require(bytecodeLenInWords < 2 ** 16, "pp"); // bytecode length must be less than 2^16 words
require(bytecodeLenInWords % 2 == 1, "pr"); // bytecode length in words must be odd
hashedBytecode =
EfficientCall.sha(_bytecode) &
0x00000000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF;
// Setting the version of the hash
hashedBytecode = (hashedBytecode | bytes32(uint256(1 << 248)));
// Setting the length
hashedBytecode = hashedBytecode | bytes32(bytecodeLenInWords << 224);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../openzeppelin/token/ERC20/IERC20.sol";
import "../openzeppelin/token/ERC20/utils/SafeERC20.sol";
import "../interfaces/IPaymasterFlow.sol";
import "../interfaces/IContractDeployer.sol";
import {ETH_TOKEN_SYSTEM_CONTRACT, BOOTLOADER_FORMAL_ADDRESS} from "../Constants.sol";
import "./RLPEncoder.sol";
import "./EfficientCall.sol";
/// @dev The type id of zkSync's EIP-712-signed transaction.
uint8 constant EIP_712_TX_TYPE = 0x71;
/// @dev The type id of legacy transactions.
uint8 constant LEGACY_TX_TYPE = 0x0;
/// @dev The type id of legacy transactions.
uint8 constant EIP_2930_TX_TYPE = 0x01;
/// @dev The type id of EIP1559 transactions.
uint8 constant EIP_1559_TX_TYPE = 0x02;
/// @notice Structure used to represent zkSync transaction.
struct Transaction {
// The type of the transaction.
uint256 txType;
// The caller.
uint256 from;
// The callee.
uint256 to;
// The gasLimit to pass with the transaction.
// It has the same meaning as Ethereum's gasLimit.
uint256 gasLimit;
// The maximum amount of gas the user is willing to pay for a byte of pubdata.
uint256 gasPerPubdataByteLimit;
// The maximum fee per gas that the user is willing to pay.
// It is akin to EIP1559's maxFeePerGas.
uint256 maxFeePerGas;
// The maximum priority fee per gas that the user is willing to pay.
// It is akin to EIP1559's maxPriorityFeePerGas.
uint256 maxPriorityFeePerGas;
// The transaction's paymaster. If there is no paymaster, it is equal to 0.
uint256 paymaster;
// The nonce of the transaction.
uint256 nonce;
// The value to pass with the transaction.
uint256 value;
// In the future, we might want to add some
// new fields to the struct. The `txData` struct
// is to be passed to account and any changes to its structure
// would mean a breaking change to these accounts. In order to prevent this,
// we should keep some fields as "reserved".
// It is also recommended that their length is fixed, since
// it would allow easier proof integration (in case we will need
// some special circuit for preprocessing transactions).
uint256[4] reserved;
// The transaction's calldata.
bytes data;
// The signature of the transaction.
bytes signature;
// The properly formatted hashes of bytecodes that must be published on L1
// with the inclusion of this transaction. Note, that a bytecode has been published
// before, the user won't pay fees for its republishing.
bytes32[] factoryDeps;
// The input to the paymaster.
bytes paymasterInput;
// Reserved dynamic type for the future use-case. Using it should be avoided,
// But it is still here, just in case we want to enable some additional functionality.
bytes reservedDynamic;
}
/**
* @author Matter Labs
* @notice Library is used to help custom accounts to work with common methods for the Transaction type.
*/
library TransactionHelper {
using SafeERC20 for IERC20;
/// @notice The EIP-712 typehash for the contract's domain
bytes32 constant EIP712_DOMAIN_TYPEHASH = keccak256("EIP712Domain(string name,string version,uint256 chainId)");
bytes32 constant EIP712_TRANSACTION_TYPE_HASH =
keccak256(
"Transaction(uint256 txType,uint256 from,uint256 to,uint256 gasLimit,uint256 gasPerPubdataByteLimit,uint256 maxFeePerGas,uint256 maxPriorityFeePerGas,uint256 paymaster,uint256 nonce,uint256 value,bytes data,bytes32[] factoryDeps,bytes paymasterInput)"
);
/// @notice Whether the token is Ethereum.
/// @param _addr The address of the token
/// @return `true` or `false` based on whether the token is Ether.
/// @dev This method assumes that address is Ether either if the address is 0 (for convenience)
/// or if the address is the address of the L2EthToken system contract.
function isEthToken(uint256 _addr) internal pure returns (bool) {
return _addr == uint256(uint160(address(ETH_TOKEN_SYSTEM_CONTRACT))) || _addr == 0;
}
/// @notice Calculate the suggested signed hash of the transaction,
/// i.e. the hash that is signed by EOAs and is recommended to be signed by other accounts.
function encodeHash(Transaction calldata _transaction) internal view returns (bytes32 resultHash) {
if (_transaction.txType == LEGACY_TX_TYPE) {
resultHash = _encodeHashLegacyTransaction(_transaction);
} else if (_transaction.txType == EIP_712_TX_TYPE) {
resultHash = _encodeHashEIP712Transaction(_transaction);
} else if (_transaction.txType == EIP_1559_TX_TYPE) {
resultHash = _encodeHashEIP1559Transaction(_transaction);
} else if (_transaction.txType == EIP_2930_TX_TYPE) {
resultHash = _encodeHashEIP2930Transaction(_transaction);
} else {
// Currently no other transaction types are supported.
// Any new transaction types will be processed in a similar manner.
revert("Encoding unsupported tx");
}
}
/// @notice Encode hash of the zkSync native transaction type.
/// @return keccak256 hash of the EIP-712 encoded representation of transaction
function _encodeHashEIP712Transaction(Transaction calldata _transaction) private view returns (bytes32) {
bytes32 structHash = keccak256(
abi.encode(
EIP712_TRANSACTION_TYPE_HASH,
_transaction.txType,
_transaction.from,
_transaction.to,
_transaction.gasLimit,
_transaction.gasPerPubdataByteLimit,
_transaction.maxFeePerGas,
_transaction.maxPriorityFeePerGas,
_transaction.paymaster,
_transaction.nonce,
_transaction.value,
EfficientCall.keccak(_transaction.data),
keccak256(abi.encodePacked(_transaction.factoryDeps)),
EfficientCall.keccak(_transaction.paymasterInput)
)
);
bytes32 domainSeparator = keccak256(
abi.encode(EIP712_DOMAIN_TYPEHASH, keccak256("zkSync"), keccak256("2"), block.chainid)
);
return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
}
/// @notice Encode hash of the legacy transaction type.
/// @return keccak256 of the serialized RLP encoded representation of transaction
function _encodeHashLegacyTransaction(Transaction calldata _transaction) private view returns (bytes32) {
// Hash of legacy transactions are encoded as one of the:
// - RLP(nonce, gasPrice, gasLimit, to, value, data, chainId, 0, 0)
// - RLP(nonce, gasPrice, gasLimit, to, value, data)
//
// In this RLP encoding, only the first one above list appears, so we encode each element
// inside list and then concatenate the length of all elements with them.
bytes memory encodedNonce = RLPEncoder.encodeUint256(_transaction.nonce);
// Encode `gasPrice` and `gasLimit` together to prevent "stack too deep error".
bytes memory encodedGasParam;
{
bytes memory encodedGasPrice = RLPEncoder.encodeUint256(_transaction.maxFeePerGas);
bytes memory encodedGasLimit = RLPEncoder.encodeUint256(_transaction.gasLimit);
encodedGasParam = bytes.concat(encodedGasPrice, encodedGasLimit);
}
bytes memory encodedTo = RLPEncoder.encodeAddress(address(uint160(_transaction.to)));
bytes memory encodedValue = RLPEncoder.encodeUint256(_transaction.value);
// Encode only the length of the transaction data, and not the data itself,
// so as not to copy to memory a potentially huge transaction data twice.
bytes memory encodedDataLength;
{
// Safe cast, because the length of the transaction data can't be so large.
uint64 txDataLen = uint64(_transaction.data.length);
if (txDataLen != 1) {
// If the length is not equal to one, then only using the length can it be encoded definitely.
encodedDataLength = RLPEncoder.encodeNonSingleBytesLen(txDataLen);
} else if (_transaction.data[0] >= 0x80) {
// If input is a byte in [0x80, 0xff] range, RLP encoding will concatenates 0x81 with the byte.
encodedDataLength = hex"81";
}
// Otherwise the length is not encoded at all.
}
// Encode `chainId` according to EIP-155, but only if the `chainId` is specified in the transaction.
bytes memory encodedChainId;
if (_transaction.reserved[0] != 0) {
encodedChainId = bytes.concat(RLPEncoder.encodeUint256(block.chainid), hex"80_80");
}
bytes memory encodedListLength;
unchecked {
uint256 listLength = encodedNonce.length +
encodedGasParam.length +
encodedTo.length +
encodedValue.length +
encodedDataLength.length +
_transaction.data.length +
encodedChainId.length;
// Safe cast, because the length of the list can't be so large.
encodedListLength = RLPEncoder.encodeListLen(uint64(listLength));
}
return
keccak256(
bytes.concat(
encodedListLength,
encodedNonce,
encodedGasParam,
encodedTo,
encodedValue,
encodedDataLength,
_transaction.data,
encodedChainId
)
);
}
/// @notice Encode hash of the EIP2930 transaction type.
/// @return keccak256 of the serialized RLP encoded representation of transaction
function _encodeHashEIP2930Transaction(Transaction calldata _transaction) private view returns (bytes32) {
// Hash of EIP2930 transactions is encoded the following way:
// H(0x01 || RLP(chain_id, nonce, gas_price, gas_limit, destination, amount, data, access_list))
//
// Note, that on zkSync access lists are not supported and should always be empty.
// Encode all fixed-length params to avoid "stack too deep error"
bytes memory encodedFixedLengthParams;
{
bytes memory encodedChainId = RLPEncoder.encodeUint256(block.chainid);
bytes memory encodedNonce = RLPEncoder.encodeUint256(_transaction.nonce);
bytes memory encodedGasPrice = RLPEncoder.encodeUint256(_transaction.maxFeePerGas);
bytes memory encodedGasLimit = RLPEncoder.encodeUint256(_transaction.gasLimit);
bytes memory encodedTo = RLPEncoder.encodeAddress(address(uint160(_transaction.to)));
bytes memory encodedValue = RLPEncoder.encodeUint256(_transaction.value);
encodedFixedLengthParams = bytes.concat(
encodedChainId,
encodedNonce,
encodedGasPrice,
encodedGasLimit,
encodedTo,
encodedValue
);
}
// Encode only the length of the transaction data, and not the data itself,
// so as not to copy to memory a potentially huge transaction data twice.
bytes memory encodedDataLength;
{
// Safe cast, because the length of the transaction data can't be so large.
uint64 txDataLen = uint64(_transaction.data.length);
if (txDataLen != 1) {
// If the length is not equal to one, then only using the length can it be encoded definitely.
encodedDataLength = RLPEncoder.encodeNonSingleBytesLen(txDataLen);
} else if (_transaction.data[0] >= 0x80) {
// If input is a byte in [0x80, 0xff] range, RLP encoding will concatenates 0x81 with the byte.
encodedDataLength = hex"81";
}
// Otherwise the length is not encoded at all.
}
// On zkSync, access lists are always zero length (at least for now).
bytes memory encodedAccessListLength = RLPEncoder.encodeListLen(0);
bytes memory encodedListLength;
unchecked {
uint256 listLength = encodedFixedLengthParams.length +
encodedDataLength.length +
_transaction.data.length +
encodedAccessListLength.length;
// Safe cast, because the length of the list can't be so large.
encodedListLength = RLPEncoder.encodeListLen(uint64(listLength));
}
return
keccak256(
bytes.concat(
"\x01",
encodedListLength,
encodedFixedLengthParams,
encodedDataLength,
_transaction.data,
encodedAccessListLength
)
);
}
/// @notice Encode hash of the EIP1559 transaction type.
/// @return keccak256 of the serialized RLP encoded representation of transaction
function _encodeHashEIP1559Transaction(Transaction calldata _transaction) private view returns (bytes32) {
// Hash of EIP1559 transactions is encoded the following way:
// H(0x02 || RLP(chain_id, nonce, max_priority_fee_per_gas, max_fee_per_gas, gas_limit, destination, amount, data, access_list))
//
// Note, that on zkSync access lists are not supported and should always be empty.
// Encode all fixed-length params to avoid "stack too deep error"
bytes memory encodedFixedLengthParams;
{
bytes memory encodedChainId = RLPEncoder.encodeUint256(block.chainid);
bytes memory encodedNonce = RLPEncoder.encodeUint256(_transaction.nonce);
bytes memory encodedMaxPriorityFeePerGas = RLPEncoder.encodeUint256(_transaction.maxPriorityFeePerGas);
bytes memory encodedMaxFeePerGas = RLPEncoder.encodeUint256(_transaction.maxFeePerGas);
bytes memory encodedGasLimit = RLPEncoder.encodeUint256(_transaction.gasLimit);
bytes memory encodedTo = RLPEncoder.encodeAddress(address(uint160(_transaction.to)));
bytes memory encodedValue = RLPEncoder.encodeUint256(_transaction.value);
encodedFixedLengthParams = bytes.concat(
encodedChainId,
encodedNonce,
encodedMaxPriorityFeePerGas,
encodedMaxFeePerGas,
encodedGasLimit,
encodedTo,
encodedValue
);
}
// Encode only the length of the transaction data, and not the data itself,
// so as not to copy to memory a potentially huge transaction data twice.
bytes memory encodedDataLength;
{
// Safe cast, because the length of the transaction data can't be so large.
uint64 txDataLen = uint64(_transaction.data.length);
if (txDataLen != 1) {
// If the length is not equal to one, then only using the length can it be encoded definitely.
encodedDataLength = RLPEncoder.encodeNonSingleBytesLen(txDataLen);
} else if (_transaction.data[0] >= 0x80) {
// If input is a byte in [0x80, 0xff] range, RLP encoding will concatenates 0x81 with the byte.
encodedDataLength = hex"81";
}
// Otherwise the length is not encoded at all.
}
// On zkSync, access lists are always zero length (at least for now).
bytes memory encodedAccessListLength = RLPEncoder.encodeListLen(0);
bytes memory encodedListLength;
unchecked {
uint256 listLength = encodedFixedLengthParams.length +
encodedDataLength.length +
_transaction.data.length +
encodedAccessListLength.length;
// Safe cast, because the length of the list can't be so large.
encodedListLength = RLPEncoder.encodeListLen(uint64(listLength));
}
return
keccak256(
bytes.concat(
"\x02",
encodedListLength,
encodedFixedLengthParams,
encodedDataLength,
_transaction.data,
encodedAccessListLength
)
);
}
/// @notice Processes the common paymaster flows, e.g. setting proper allowance
/// for tokens, etc. For more information on the expected behavior, check out
/// the "Paymaster flows" section in the documentation.
function processPaymasterInput(Transaction calldata _transaction) internal {
require(_transaction.paymasterInput.length >= 4, "The standard paymaster input must be at least 4 bytes long");
bytes4 paymasterInputSelector = bytes4(_transaction.paymasterInput[0:4]);
if (paymasterInputSelector == IPaymasterFlow.approvalBased.selector) {
require(
_transaction.paymasterInput.length >= 68,
"The approvalBased paymaster input must be at least 68 bytes long"
);
// While the actual data consists of address, uint256 and bytes data,
// the data is needed only for the paymaster, so we ignore it here for the sake of optimization
(address token, uint256 minAllowance) = abi.decode(_transaction.paymasterInput[4:68], (address, uint256));
address paymaster = address(uint160(_transaction.paymaster));
uint256 currentAllowance = IERC20(token).allowance(address(this), paymaster);
if (currentAllowance < minAllowance) {
// Some tokens, e.g. USDT require that the allowance is firsty set to zero
// and only then updated to the new value.
IERC20(token).safeApprove(paymaster, 0);
IERC20(token).safeApprove(paymaster, minAllowance);
}
} else if (paymasterInputSelector == IPaymasterFlow.general.selector) {
// Do nothing. general(bytes) paymaster flow means that the paymaster must interpret these bytes on his own.
} else {
revert("Unsupported paymaster flow");
}
}
/// @notice Pays the required fee for the transaction to the bootloader.
/// @dev Currently it pays the maximum amount "_transaction.maxFeePerGas * _transaction.gasLimit",
/// it will change in the future.
function payToTheBootloader(Transaction calldata _transaction) internal returns (bool success) {
address bootloaderAddr = BOOTLOADER_FORMAL_ADDRESS;
uint256 amount = _transaction.maxFeePerGas * _transaction.gasLimit;
assembly {
success := call(gas(), bootloaderAddr, amount, 0, 0, 0, 0)
}
}
// Returns the balance required to process the transaction.
function totalRequiredBalance(Transaction calldata _transaction) internal pure returns (uint256 requiredBalance) {
if (address(uint160(_transaction.paymaster)) != address(0)) {
// Paymaster pays for the fee
requiredBalance = _transaction.value;
} else {
// The user should have enough balance for both the fee and the value of the transaction
requiredBalance = _transaction.maxFeePerGas * _transaction.gasLimit + _transaction.value;
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8;
import {MAX_SYSTEM_CONTRACT_ADDRESS, MSG_VALUE_SYSTEM_CONTRACT} from "../Constants.sol";
import "./SystemContractsCaller.sol";
import "./Utils.sol";
uint256 constant UINT32_MASK = 0xffffffff;
uint256 constant UINT128_MASK = 0xffffffffffffffffffffffffffffffff;
/// @dev The mask that is used to convert any uint256 to a proper address.
/// It needs to be padded with `00` to be treated as uint256 by Solidity
uint256 constant ADDRESS_MASK = 0x00ffffffffffffffffffffffffffffffffffffffff;
struct ZkSyncMeta {
uint32 gasPerPubdataByte;
uint32 heapSize;
uint32 auxHeapSize;
uint8 shardId;
uint8 callerShardId;
uint8 codeShardId;
}
enum Global {
CalldataPtr,
CallFlags,
ExtraABIData1,
ExtraABIData2,
ReturndataPtr
}
/**
* @author Matter Labs
* @notice Library used for accessing zkEVM-specific opcodes, needed for the development
* of system contracts.
* @dev While this library will be eventually available to public, some of the provided
* methods won't work for non-system contracts. We will not recommend this library
* for external use.
*/
library SystemContractHelper {
/// @notice Send an L2Log to L1.
/// @param _isService The `isService` flag.
/// @param _key The `key` part of the L2Log.
/// @param _value The `value` part of the L2Log.
/// @dev The meaning of all these parameters is context-dependent, but they
/// have no intrinsic meaning per se.
function toL1(bool _isService, bytes32 _key, bytes32 _value) internal {
address callAddr = TO_L1_CALL_ADDRESS;
assembly {
// Ensuring that the type is bool
_isService := and(_isService, 1)
// This `success` is always 0, but the method always succeeds
// (except for the cases when there is not enough gas)
let success := call(_isService, callAddr, _key, _value, 0xFFFF, 0, 0)
}
}
/// @notice Get address of the currently executed code.
/// @dev This allows differentiating between `call` and `delegatecall`.
/// During the former `this` and `codeAddress` are the same, while
/// during the latter they are not.
function getCodeAddress() internal view returns (address addr) {
address callAddr = CODE_ADDRESS_CALL_ADDRESS;
assembly {
addr := staticcall(0, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Provide a compiler hint, by placing calldata fat pointer into virtual `ACTIVE_PTR`,
/// that can be manipulated by `ptr.add`/`ptr.sub`/`ptr.pack`/`ptr.shrink` later.
/// @dev This allows making a call by forwarding calldata pointer to the child call.
/// It is a much more efficient way to forward calldata, than standard EVM bytes copying.
function loadCalldataIntoActivePtr() internal view {
address callAddr = LOAD_CALLDATA_INTO_ACTIVE_PTR_CALL_ADDRESS;
assembly {
pop(staticcall(0, callAddr, 0, 0xFFFF, 0, 0))
}
}
/// @notice Compiler simulation of the `ptr.pack` opcode for the virtual `ACTIVE_PTR` pointer.
/// @dev Do the concatenation between lowest part of `ACTIVE_PTR` and highest part of `_farCallAbi`
/// forming packed fat pointer for a far call or ret ABI when necessary.
/// Note: Panics if the lowest 128 bits of `_farCallAbi` are not zeroes.
function ptrPackIntoActivePtr(uint256 _farCallAbi) internal view {
address callAddr = PTR_PACK_INTO_ACTIVE_CALL_ADDRESS;
assembly {
pop(staticcall(_farCallAbi, callAddr, 0, 0xFFFF, 0, 0))
}
}
/// @notice Compiler simulation of the `ptr.add` opcode for the virtual `ACTIVE_PTR` pointer.
/// @dev Transforms `ACTIVE_PTR.offset` into `ACTIVE_PTR.offset + u32(_value)`. If overflow happens then it panics.
function ptrAddIntoActive(uint32 _value) internal view {
address callAddr = PTR_ADD_INTO_ACTIVE_CALL_ADDRESS;
uint256 cleanupMask = UINT32_MASK;
assembly {
// Clearing input params as they are not cleaned by Solidity by default
_value := and(_value, cleanupMask)
pop(staticcall(_value, callAddr, 0, 0xFFFF, 0, 0))
}
}
/// @notice Compiler simulation of the `ptr.shrink` opcode for the virtual `ACTIVE_PTR` pointer.
/// @dev Transforms `ACTIVE_PTR.length` into `ACTIVE_PTR.length - u32(_shrink)`. If underflow happens then it panics.
function ptrShrinkIntoActive(uint32 _shrink) internal view {
address callAddr = PTR_SHRINK_INTO_ACTIVE_CALL_ADDRESS;
uint256 cleanupMask = UINT32_MASK;
assembly {
// Clearing input params as they are not cleaned by Solidity by default
_shrink := and(_shrink, cleanupMask)
pop(staticcall(_shrink, callAddr, 0, 0xFFFF, 0, 0))
}
}
/// @notice packs precompile parameters into one word
/// @param _inputMemoryOffset The memory offset in 32-byte words for the input data for calling the precompile.
/// @param _inputMemoryLength The length of the input data in words.
/// @param _outputMemoryOffset The memory offset in 32-byte words for the output data.
/// @param _outputMemoryLength The length of the output data in words.
/// @param _perPrecompileInterpreted The constant, the meaning of which is defined separately for
/// each precompile. For information, please read the documentation of the precompilecall log in
/// the VM.
function packPrecompileParams(
uint32 _inputMemoryOffset,
uint32 _inputMemoryLength,
uint32 _outputMemoryOffset,
uint32 _outputMemoryLength,
uint64 _perPrecompileInterpreted
) internal pure returns (uint256 rawParams) {
rawParams = _inputMemoryOffset;
rawParams |= uint256(_inputMemoryLength) << 32;
rawParams |= uint256(_outputMemoryOffset) << 64;
rawParams |= uint256(_outputMemoryLength) << 96;
rawParams |= uint256(_perPrecompileInterpreted) << 192;
}
/// @notice Call precompile with given parameters.
/// @param _rawParams The packed precompile params. They can be retrieved by
/// the `packPrecompileParams` method.
/// @param _gasToBurn The number of gas to burn during this call.
/// @return success Whether the call was successful.
/// @dev The list of currently available precompiles sha256, keccak256, ecrecover.
/// NOTE: The precompile type depends on `this` which calls precompile, which means that only
/// system contracts corresponding to the list of precompiles above can do `precompileCall`.
/// @dev If used not in the `sha256`, `keccak256` or `ecrecover` contracts, it will just burn the gas provided.
function precompileCall(uint256 _rawParams, uint32 _gasToBurn) internal view returns (bool success) {
address callAddr = PRECOMPILE_CALL_ADDRESS;
// After `precompileCall` gas will be burned down to 0 if there are not enough of them,
// thats why it should be checked before the call.
require(gasleft() >= _gasToBurn);
uint256 cleanupMask = UINT32_MASK;
assembly {
// Clearing input params as they are not cleaned by Solidity by default
_gasToBurn := and(_gasToBurn, cleanupMask)
success := staticcall(_rawParams, callAddr, _gasToBurn, 0xFFFF, 0, 0)
}
}
/// @notice Set `msg.value` to next far call.
/// @param _value The msg.value that will be used for the *next* call.
/// @dev If called not in kernel mode, it will result in a revert (enforced by the VM)
function setValueForNextFarCall(uint128 _value) internal returns (bool success) {
uint256 cleanupMask = UINT128_MASK;
address callAddr = SET_CONTEXT_VALUE_CALL_ADDRESS;
assembly {
// Clearing input params as they are not cleaned by Solidity by default
_value := and(_value, cleanupMask)
success := call(0, callAddr, _value, 0, 0xFFFF, 0, 0)
}
}
/// @notice Initialize a new event.
/// @param initializer The event initializing value.
/// @param value1 The first topic or data chunk.
function eventInitialize(uint256 initializer, uint256 value1) internal {
address callAddr = EVENT_INITIALIZE_ADDRESS;
assembly {
pop(call(initializer, callAddr, value1, 0, 0xFFFF, 0, 0))
}
}
/// @notice Continue writing the previously initialized event.
/// @param value1 The first topic or data chunk.
/// @param value2 The second topic or data chunk.
function eventWrite(uint256 value1, uint256 value2) internal {
address callAddr = EVENT_WRITE_ADDRESS;
assembly {
pop(call(value1, callAddr, value2, 0, 0xFFFF, 0, 0))
}
}
/// @notice Get the packed representation of the `ZkSyncMeta` from the current context.
/// @return meta The packed representation of the ZkSyncMeta.
/// @dev The fields in ZkSyncMeta are NOT tightly packed, i.e. there is a special rule on how
/// they are packed. For more information, please read the documentation on ZkSyncMeta.
function getZkSyncMetaBytes() internal view returns (uint256 meta) {
address callAddr = META_CALL_ADDRESS;
assembly {
meta := staticcall(0, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Returns the bits [offset..offset+size-1] of the meta.
/// @param meta Packed representation of the ZkSyncMeta.
/// @param offset The offset of the bits.
/// @param size The size of the extracted number in bits.
/// @return result The extracted number.
function extractNumberFromMeta(uint256 meta, uint256 offset, uint256 size) internal pure returns (uint256 result) {
// Firstly, we delete all the bits after the field
uint256 shifted = (meta << (256 - size - offset));
// Then we shift everything back
result = (shifted >> (256 - size));
}
/// @notice Given the packed representation of `ZkSyncMeta`, retrieves the number of gas
/// that a single byte sent to L1 as pubdata costs.
/// @param meta Packed representation of the ZkSyncMeta.
/// @return gasPerPubdataByte The current price in gas per pubdata byte.
function getGasPerPubdataByteFromMeta(uint256 meta) internal pure returns (uint32 gasPerPubdataByte) {
gasPerPubdataByte = uint32(extractNumberFromMeta(meta, META_GAS_PER_PUBDATA_BYTE_OFFSET, 32));
}
/// @notice Given the packed representation of `ZkSyncMeta`, retrieves the number of the current size
/// of the heap in bytes.
/// @param meta Packed representation of the ZkSyncMeta.
/// @return heapSize The size of the memory in bytes byte.
/// @dev The following expression: getHeapSizeFromMeta(getZkSyncMetaBytes()) is
/// equivalent to the MSIZE in Solidity.
function getHeapSizeFromMeta(uint256 meta) internal pure returns (uint32 heapSize) {
heapSize = uint32(extractNumberFromMeta(meta, META_HEAP_SIZE_OFFSET, 32));
}
/// @notice Given the packed representation of `ZkSyncMeta`, retrieves the number of the current size
/// of the auxilary heap in bytes.
/// @param meta Packed representation of the ZkSyncMeta.
/// @return auxHeapSize The size of the auxilary memory in bytes byte.
/// @dev You can read more on auxilary memory in the VM1.2 documentation.
function getAuxHeapSizeFromMeta(uint256 meta) internal pure returns (uint32 auxHeapSize) {
auxHeapSize = uint32(extractNumberFromMeta(meta, META_AUX_HEAP_SIZE_OFFSET, 32));
}
/// @notice Given the packed representation of `ZkSyncMeta`, retrieves the shardId of `this`.
/// @param meta Packed representation of the ZkSyncMeta.
/// @return shardId The shardId of `this`.
/// @dev Currently only shard 0 (zkRollup) is supported.
function getShardIdFromMeta(uint256 meta) internal pure returns (uint8 shardId) {
shardId = uint8(extractNumberFromMeta(meta, META_SHARD_ID_OFFSET, 8));
}
/// @notice Given the packed representation of `ZkSyncMeta`, retrieves the shardId of
/// the msg.sender.
/// @param meta Packed representation of the ZkSyncMeta.
/// @return callerShardId The shardId of the msg.sender.
/// @dev Currently only shard 0 (zkRollup) is supported.
function getCallerShardIdFromMeta(uint256 meta) internal pure returns (uint8 callerShardId) {
callerShardId = uint8(extractNumberFromMeta(meta, META_CALLER_SHARD_ID_OFFSET, 8));
}
/// @notice Given the packed representation of `ZkSyncMeta`, retrieves the shardId of
/// the currently executed code.
/// @param meta Packed representation of the ZkSyncMeta.
/// @return codeShardId The shardId of the currently executed code.
/// @dev Currently only shard 0 (zkRollup) is supported.
function getCodeShardIdFromMeta(uint256 meta) internal pure returns (uint8 codeShardId) {
codeShardId = uint8(extractNumberFromMeta(meta, META_CODE_SHARD_ID_OFFSET, 8));
}
/// @notice Retrieves the ZkSyncMeta structure.
/// @return meta The ZkSyncMeta execution context parameters.
function getZkSyncMeta() internal view returns (ZkSyncMeta memory meta) {
uint256 metaPacked = getZkSyncMetaBytes();
meta.gasPerPubdataByte = getGasPerPubdataByteFromMeta(metaPacked);
meta.shardId = getShardIdFromMeta(metaPacked);
meta.callerShardId = getCallerShardIdFromMeta(metaPacked);
meta.codeShardId = getCodeShardIdFromMeta(metaPacked);
}
/// @notice Returns the call flags for the current call.
/// @return callFlags The bitmask of the callflags.
/// @dev Call flags is the value of the first register
/// at the start of the call.
/// @dev The zero bit of the callFlags indicates whether the call is
/// a constructor call. The first bit of the callFlags indicates whether
/// the call is a system one.
function getCallFlags() internal view returns (uint256 callFlags) {
address callAddr = CALLFLAGS_CALL_ADDRESS;
assembly {
callFlags := staticcall(0, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Returns the current calldata pointer.
/// @return ptr The current calldata pointer.
/// @dev NOTE: This file is just an integer and it can not be used
/// to forward the calldata to the next calls in any way.
function getCalldataPtr() internal view returns (uint256 ptr) {
address callAddr = PTR_CALLDATA_CALL_ADDRESS;
assembly {
ptr := staticcall(0, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Returns the N-th extraAbiParam for the current call.
/// @return extraAbiData The value of the N-th extraAbiParam for this call.
/// @dev It is equal to the value of the (N+2)-th register
/// at the start of the call.
function getExtraAbiData(uint256 index) internal view returns (uint256 extraAbiData) {
require(index < 10, "There are only 10 accessible registers");
address callAddr = GET_EXTRA_ABI_DATA_ADDRESS;
assembly {
extraAbiData := staticcall(index, callAddr, 0, 0xFFFF, 0, 0)
}
}
/// @notice Retuns whether the current call is a system call.
/// @return `true` or `false` based on whether the current call is a system call.
function isSystemCall() internal view returns (bool) {
uint256 callFlags = getCallFlags();
// When the system call is passed, the 2-bit it set to 1
return (callFlags & 2) != 0;
}
/// @notice Returns whether the address is a system contract.
/// @param _address The address to test
/// @return `true` or `false` based on whether the `_address` is a system contract.
function isSystemContract(address _address) internal pure returns (bool) {
return uint160(_address) <= uint160(MAX_SYSTEM_CONTRACT_ADDRESS);
}
}
/// @dev Solidity does not allow exporting modifiers via libraries, so
/// the only way to do reuse modifiers is to have a base contract
abstract contract ISystemContract {
/// @notice Modifier that makes sure that the method
/// can only be called via a system call.
modifier onlySystemCall() {
require(
SystemContractHelper.isSystemCall() || SystemContractHelper.isSystemContract(msg.sender),
"This method require system call flag"
);
_;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol)
pragma solidity ^0.8.20;
/**
* @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
* behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
* external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
* function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
*
* The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
* reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
* case an upgrade adds a module that needs to be initialized.
*
* For example:
*
* [.hljs-theme-light.nopadding]
* ```solidity
* contract MyToken is ERC20Upgradeable {
* function initialize() initializer public {
* __ERC20_init("MyToken", "MTK");
* }
* }
*
* contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
* function initializeV2() reinitializer(2) public {
* __ERC20Permit_init("MyToken");
* }
* }
* ```
*
* TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
* possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
*
* CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
* that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
*
* [CAUTION]
* ====
* Avoid leaving a contract uninitialized.
*
* An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
* contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
* the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
*
* [.hljs-theme-light.nopadding]
* ```
* /// @custom:oz-upgrades-unsafe-allow constructor
* constructor() {
* _disableInitializers();
* }
* ```
* ====
*/
abstract contract Initializable {
/**
* @dev Storage of the initializable contract.
*
* It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions
* when using with upgradeable contracts.
*
* @custom:storage-location erc7201:openzeppelin.storage.Initializable
*/
struct InitializableStorage {
/**
* @dev Indicates that the contract has been initialized.
*/
uint64 _initialized;
/**
* @dev Indicates that the contract is in the process of being initialized.
*/
bool _initializing;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;
/**
* @dev The contract is already initialized.
*/
error InvalidInitialization();
/**
* @dev The contract is not initializing.
*/
error NotInitializing();
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint64 version);
/**
* @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
* `onlyInitializing` functions can be used to initialize parent contracts.
*
* Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any
* number of times. This behavior in the constructor can be useful during testing and is not expected to be used in
* production.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
// solhint-disable-next-line var-name-mixedcase
InitializableStorage storage $ = _getInitializableStorage();
// Cache values to avoid duplicated sloads
bool isTopLevelCall = !$._initializing;
uint64 initialized = $._initialized;
// Allowed calls:
// - initialSetup: the contract is not in the initializing state and no previous version was
// initialized
// - construction: the contract is initialized at version 1 (no reininitialization) and the
// current contract is just being deployed
bool initialSetup = initialized == 0 && isTopLevelCall;
bool construction = initialized == 1 && address(this).code.length == 0;
if (!initialSetup && !construction) {
revert InvalidInitialization();
}
$._initialized = 1;
if (isTopLevelCall) {
$._initializing = true;
}
_;
if (isTopLevelCall) {
$._initializing = false;
emit Initialized(1);
}
}
/**
* @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
* contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
* used to initialize parent contracts.
*
* A reinitializer may be used after the original initialization step. This is essential to configure modules that
* are added through upgrades and that require initialization.
*
* When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
* cannot be nested. If one is invoked in the context of another, execution will revert.
*
* Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
* a contract, executing them in the right order is up to the developer or operator.
*
* WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint64 version) {
// solhint-disable-next-line var-name-mixedcase
InitializableStorage storage $ = _getInitializableStorage();
if ($._initializing || $._initialized >= version) {
revert InvalidInitialization();
}
$._initialized = version;
$._initializing = true;
_;
$._initializing = false;
emit Initialized(version);
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} and {reinitializer} modifiers, directly or indirectly.
*/
modifier onlyInitializing() {
_checkInitializing();
_;
}
/**
* @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.
*/
function _checkInitializing() internal view virtual {
if (!_isInitializing()) {
revert NotInitializing();
}
}
/**
* @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
* Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
* to any version. It is recommended to use this to lock implementation contracts that are designed to be called
* through proxies.
*
* Emits an {Initialized} event the first time it is successfully executed.
*/
function _disableInitializers() internal virtual {
// solhint-disable-next-line var-name-mixedcase
InitializableStorage storage $ = _getInitializableStorage();
if ($._initializing) {
revert InvalidInitialization();
}
if ($._initialized != type(uint64).max) {
$._initialized = type(uint64).max;
emit Initialized(type(uint64).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint64) {
return _getInitializableStorage()._initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _getInitializableStorage()._initializing;
}
/**
* @dev Returns a pointer to the storage namespace.
*/
// solhint-disable-next-line var-name-mixedcase
function _getInitializableStorage() private pure returns (InitializableStorage storage $) {
assembly {
$.slot := INITIALIZABLE_STORAGE
}
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
interface IAGWRegistry {
function register(address account) external;
function isAGW(address account) external view returns (bool);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {IInitable} from '../interfaces/IInitable.sol';
import {IERC165} from '@openzeppelin/contracts/utils/introspection/IERC165.sol';
interface IModule is IInitable, IERC165 {}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
library AGWStorage {
//keccak256('agw.contracts.AGWStorage') - 1
bytes32 private constant AGW_STORAGE_SLOT =
0x67641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d42d;
struct Layout {
// ┌───────────────────┐
// │ Ownership Data │
mapping(bytes => bytes) r1Owners;
mapping(address => address) k1Owners;
uint256[50] __gap_0;
// └───────────────────┘
// ┌───────────────────┐
// │ Fallback │
address defaultFallbackContract; // for next version
uint256[50] __gap_1;
// └───────────────────┘
// ┌───────────────────┐
// │ Validation │
mapping(address => address) r1Validators;
mapping(address => address) k1Validators;
mapping(address => address) moduleValidators;
uint256[49] __gap_2;
// └───────────────────┘
// ┌───────────────────┐
// │ Module │
mapping(address => address) modules;
uint256[50] __gap_3;
// └───────────────────┘
// ┌───────────────────┐
// │ Hooks │
mapping(address => address) validationHooks;
mapping(address => address) executionHooks;
mapping(address => mapping(bytes32 => bytes)) hookDataStore;
uint256[50] __gap_4;
// └───────────────────┘
}
function layout() internal pure returns (Layout storage l) {
bytes32 slot = AGW_STORAGE_SLOT;
assembly {
l.slot := slot
}
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
interface IInitable {
event Inited(address indexed account);
event Disabled(address indexed account);
function init(bytes calldata initData) external;
function disable() external;
function isInited(address account) external view returns (bool);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Errors} from '../libraries/Errors.sol';
/**
* @title Bytes linked list library
* @notice Helper library for bytes linkedlist operations
* @author https://getclave.io
*/
library BytesLinkedList {
bytes internal constant SENTINEL_BYTES = hex'00';
uint8 internal constant SENTINEL_LENGTH = 1;
modifier validBytes(bytes calldata value) {
if (value.length <= SENTINEL_LENGTH) {
revert Errors.INVALID_BYTES();
}
_;
}
function add(
mapping(bytes => bytes) storage self,
bytes calldata value
) internal validBytes(value) {
if (self[value].length != 0) {
revert Errors.BYTES_ALREADY_EXISTS();
}
bytes memory prev = self[SENTINEL_BYTES];
if (prev.length < SENTINEL_LENGTH) {
self[SENTINEL_BYTES] = value;
self[value] = SENTINEL_BYTES;
} else {
self[SENTINEL_BYTES] = value;
self[value] = prev;
}
}
function replace(
mapping(bytes => bytes) storage self,
bytes calldata oldValue,
bytes calldata newValue
) internal {
if (!exists(self, oldValue)) {
revert Errors.BYTES_NOT_EXISTS();
}
if (exists(self, newValue)) {
revert Errors.BYTES_ALREADY_EXISTS();
}
bytes memory cursor = SENTINEL_BYTES;
while (true) {
bytes memory _value = self[cursor];
if (equals(_value, oldValue)) {
bytes memory next = self[_value];
self[newValue] = next;
self[cursor] = newValue;
delete self[_value];
return;
}
cursor = _value;
}
}
function replaceUsingPrev(
mapping(bytes => bytes) storage self,
bytes calldata prevValue,
bytes calldata oldValue,
bytes calldata newValue
) internal {
if (!exists(self, oldValue)) {
revert Errors.BYTES_NOT_EXISTS();
}
if (exists(self, newValue)) {
revert Errors.BYTES_ALREADY_EXISTS();
}
if (!equals(self[prevValue], oldValue)) {
revert Errors.INVALID_PREV();
}
self[newValue] = self[oldValue];
self[prevValue] = newValue;
delete self[oldValue];
}
function remove(mapping(bytes => bytes) storage self, bytes calldata value) internal {
if (!exists(self, value)) {
revert Errors.BYTES_NOT_EXISTS();
}
bytes memory cursor = SENTINEL_BYTES;
while (true) {
bytes memory _value = self[cursor];
if (equals(_value, value)) {
bytes memory next = self[_value];
self[cursor] = next;
delete self[_value];
return;
}
cursor = _value;
}
}
function removeUsingPrev(
mapping(bytes => bytes) storage self,
bytes calldata prevValue,
bytes calldata value
) internal {
if (!exists(self, value)) {
revert Errors.BYTES_NOT_EXISTS();
}
if (!equals(self[prevValue], value)) {
revert Errors.INVALID_PREV();
}
self[prevValue] = self[value];
delete self[value];
}
function clear(mapping(bytes => bytes) storage self) internal {
bytes memory cursor = SENTINEL_BYTES;
do {
bytes memory nextCursor = self[cursor];
delete self[cursor];
cursor = nextCursor;
} while (cursor.length > SENTINEL_LENGTH);
}
function exists(
mapping(bytes => bytes) storage self,
bytes calldata value
) internal view validBytes(value) returns (bool) {
return self[value].length != 0;
}
function size(mapping(bytes => bytes) storage self) internal view returns (uint256) {
uint256 result = 0;
bytes memory cursor = self[SENTINEL_BYTES];
while (cursor.length > SENTINEL_LENGTH) {
cursor = self[cursor];
unchecked {
result++;
}
}
return result;
}
function isEmpty(mapping(bytes => bytes) storage self) internal view returns (bool) {
return self[SENTINEL_BYTES].length <= SENTINEL_LENGTH;
}
function list(mapping(bytes => bytes) storage self) internal view returns (bytes[] memory) {
uint256 _size = size(self);
bytes[] memory result = new bytes[](_size);
uint256 i = 0;
bytes memory cursor = self[SENTINEL_BYTES];
while (cursor.length > SENTINEL_LENGTH) {
result[i] = cursor;
cursor = self[cursor];
unchecked {
i++;
}
}
return result;
}
function equals(bytes memory a, bytes memory b) private pure returns (bool result) {
assembly {
result := eq(keccak256(add(a, 0x20), mload(a)), keccak256(add(b, 0x20), mload(b)))
}
}
}
/**
* @title Address linked list library
* @notice Helper library for address linkedlist operations
*/
library AddressLinkedList {
address internal constant SENTINEL_ADDRESS = address(1);
modifier validAddress(address value) {
if (value <= SENTINEL_ADDRESS) {
revert Errors.INVALID_ADDRESS();
}
_;
}
function add(
mapping(address => address) storage self,
address value
) internal validAddress(value) {
if (self[value] != address(0)) {
revert Errors.ADDRESS_ALREADY_EXISTS();
}
address prev = self[SENTINEL_ADDRESS];
if (prev == address(0)) {
self[SENTINEL_ADDRESS] = value;
self[value] = SENTINEL_ADDRESS;
} else {
self[SENTINEL_ADDRESS] = value;
self[value] = prev;
}
}
function replace(
mapping(address => address) storage self,
address oldValue,
address newValue
) internal {
if (!exists(self, oldValue)) {
revert Errors.ADDRESS_NOT_EXISTS();
}
if (exists(self, newValue)) {
revert Errors.ADDRESS_ALREADY_EXISTS();
}
address cursor = SENTINEL_ADDRESS;
while (true) {
address _value = self[cursor];
if (_value == oldValue) {
address next = self[_value];
self[newValue] = next;
self[cursor] = newValue;
delete self[_value];
return;
}
cursor = _value;
}
}
function replaceUsingPrev(
mapping(address => address) storage self,
address prevValue,
address oldValue,
address newValue
) internal {
if (!exists(self, oldValue)) {
revert Errors.ADDRESS_NOT_EXISTS();
}
if (exists(self, newValue)) {
revert Errors.ADDRESS_ALREADY_EXISTS();
}
if (self[prevValue] != oldValue) {
revert Errors.INVALID_PREV();
}
self[newValue] = self[oldValue];
self[prevValue] = newValue;
delete self[oldValue];
}
function remove(mapping(address => address) storage self, address value) internal {
if (!exists(self, value)) {
revert Errors.ADDRESS_NOT_EXISTS();
}
address cursor = SENTINEL_ADDRESS;
while (true) {
address _value = self[cursor];
if (_value == value) {
address next = self[_value];
self[cursor] = next;
delete self[_value];
return;
}
cursor = _value;
}
}
function removeUsingPrev(
mapping(address => address) storage self,
address prevValue,
address value
) internal {
if (!exists(self, value)) {
revert Errors.ADDRESS_NOT_EXISTS();
}
if (self[prevValue] != value) {
revert Errors.INVALID_PREV();
}
self[prevValue] = self[value];
delete self[value];
}
function clear(mapping(address => address) storage self) internal {
address cursor = SENTINEL_ADDRESS;
do {
address nextCursor = self[cursor];
delete self[cursor];
cursor = nextCursor;
} while (cursor > SENTINEL_ADDRESS);
}
function exists(
mapping(address => address) storage self,
address value
) internal view validAddress(value) returns (bool) {
return self[value] != address(0);
}
function size(mapping(address => address) storage self) internal view returns (uint256) {
uint256 result = 0;
address cursor = self[SENTINEL_ADDRESS];
while (cursor > SENTINEL_ADDRESS) {
cursor = self[cursor];
unchecked {
result++;
}
}
return result;
}
function isEmpty(mapping(address => address) storage self) internal view returns (bool) {
return self[SENTINEL_ADDRESS] <= SENTINEL_ADDRESS;
}
function list(
mapping(address => address) storage self
) internal view returns (address[] memory) {
uint256 _size = size(self);
address[] memory result = new address[](_size);
uint256 i = 0;
address cursor = self[SENTINEL_ADDRESS];
while (cursor > SENTINEL_ADDRESS) {
result[i] = cursor;
cursor = self[cursor];
unchecked {
i++;
}
}
return result;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {BootloaderAuth} from './BootloaderAuth.sol';
import {ModuleAuth} from './ModuleAuth.sol';
import {SelfAuth} from './SelfAuth.sol';
import {HookAuth} from './HookAuth.sol';
import {Errors} from '../libraries/Errors.sol';
/**
* @title Auth
* @notice Abstract contract that organizes authentification logic for the contract
* @author https://getclave.io
*/
abstract contract Auth is BootloaderAuth, SelfAuth, ModuleAuth, HookAuth {
modifier onlySelfOrModule() {
if (msg.sender != address(this) && !_isModule(msg.sender)) {
revert Errors.NOT_FROM_SELF_OR_MODULE();
}
_;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
/**
* @title Interface of the manager contract for modules
* @author https://getclave.io
*/
interface IModuleManager {
/**
* @notice Event emitted when a module is added
* @param module address - Address of the added module
*/
event AddModule(address indexed module);
/**
* @notice Event emitted when a module is removed
* @param module address - Address of the removed module
*/
event RemoveModule(address indexed module);
/**
* @notice Add a module to the list of modules and call it's init function
* @dev Can only be called by self or a module
* @param moduleAndData bytes calldata - Address of the module and data to initialize it with
*/
function addModule(bytes calldata moduleAndData) external;
/**
* @notice Remove a module from the list of modules and call it's disable function
* @dev Can only be called by self or a module
* @param module address - Address of the module to remove
*/
function removeModule(address module) external;
/**
* @notice Allow modules to execute arbitrary calls on behalf of the account
* @dev Can only be called by a module
* @param to address - Address to call
* @param value uint256 - Eth to send with call
* @param data bytes memory - Data to make the call with
*/
function executeFromModule(address to, uint256 value, bytes memory data) external;
/**
* @notice Check if an address is in the list of modules
* @param addr address - Address to check
* @return bool - True if the address is a module, false otherwise
*/
function isModule(address addr) external view returns (bool);
/**
* @notice Get the list of modules
* @return moduleList address[] memory - List of modules
*/
function listModules() external view returns (address[] memory moduleList);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {SignatureDecoder} from '../libraries/SignatureDecoder.sol';
import {BytesLinkedList, AddressLinkedList} from '../libraries/LinkedList.sol';
import {OwnerManager} from '../managers/OwnerManager.sol';
import {ValidatorManager} from '../managers/ValidatorManager.sol';
import {IK1Validator, IR1Validator} from '../interfaces/IValidator.sol';
import {IModuleValidator} from '../interfaces/IModuleValidator.sol';
import {OperationType} from '../interfaces/IValidator.sol';
/**
* @title ValidationHandler
* @notice Contract which calls validators for signature validation
* @author https://getclave.io
*/
abstract contract ValidationHandler is OwnerManager, ValidatorManager {
function _handleValidation(
address validator,
OperationType operationType,
bytes32 signedHash,
bytes memory signature
) internal view returns (bool) {
if (validator <= AddressLinkedList.SENTINEL_ADDRESS) {
// address less than or equal to sentinel address can't be used in linked list
// implementation so this scenario is never valid
return false;
} else if (_r1IsValidator(validator)) {
mapping(bytes => bytes) storage owners = OwnerManager._r1OwnersLinkedList();
bytes memory cursor = owners[BytesLinkedList.SENTINEL_BYTES];
while (cursor.length > BytesLinkedList.SENTINEL_LENGTH) {
bytes32[2] memory pubKey = abi.decode(cursor, (bytes32[2]));
bool _success = IR1Validator(validator).validateSignature(
operationType,
signedHash,
signature,
pubKey
);
if (_success) {
return true;
}
cursor = owners[cursor];
}
} else if (_k1IsValidator(validator)) {
address recoveredAddress = IK1Validator(validator).validateSignature(
operationType,
signedHash,
signature
);
if (recoveredAddress == address(0)) {
return false;
}
if (OwnerManager._k1IsOwner(recoveredAddress)) {
return true;
}
} else if ( _isModuleValidator(validator)) {
return IModuleValidator(validator).handleValidation(operationType, signedHash, signature);
}
return false;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
/**
* @title Interface of the upgrade manager contract
* @author https://getclave.io
*/
interface IUpgradeManager {
/**
* @notice Event emitted when the contract is upgraded
* @param oldImplementation address - Address of the old implementation contract
* @param newImplementation address - Address of the new implementation contract
*/
event Upgraded(address indexed oldImplementation, address indexed newImplementation);
/**
* @notice Upgrades the account contract to a new implementation
* @dev Can only be called by self
* @param newImplementation address - Address of the new implementation contract
*/
function upgradeTo(address newImplementation) external;
/**
* @notice Returns the current implementation address
* @return address - Address of the current implementation contract
*/
function implementationAddress() external view returns (address);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Transaction} from '@matterlabs/zksync-contracts/l2/system-contracts/libraries/TransactionHelper.sol';
import {IInitable} from '../interfaces/IInitable.sol';
import {IERC165} from '@openzeppelin/contracts/utils/introspection/IERC165.sol';
interface IValidationHook is IInitable, IERC165 {
function validationHook(
bytes32 signedHash,
Transaction calldata transaction,
bytes calldata hookData
) external;
}
interface IExecutionHook is IInitable, IERC165 {
function preExecutionHook(
Transaction calldata transaction
) external returns (bytes memory context);
function postExecutionHook(bytes memory context) external;
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
/**
* @title Interface of the manager contract for hooks
* @author https://getclave.io
*/
interface IHookManager {
/**
* @notice Event emitted when a hook is added
* @param hook address - Address of the added hook
*/
event AddHook(address indexed hook);
/**
* @notice Event emitted when a hook is removed
* @param hook address - Address of the removed hook
*/
event RemoveHook(address indexed hook);
/**
* @notice Add a hook to the list of hooks and call it's init function
* @dev Can only be called by self or a module
* @param hookAndData bytes calldata - Address of the hook and data to initialize it with
* @param isValidation bool - True if the hook is a validation hook, false otherwise
*/
function addHook(bytes calldata hookAndData, bool isValidation) external;
/**
* @notice Remove a hook from the list of hooks and call it's disable function
* @dev Can only be called by self or a module
* @param hook address - Address of the hook to remove
* @param isValidation bool - True if the hook is a validation hook, false otherwise
*/
function removeHook(address hook, bool isValidation) external;
/**
* @notice Allow a hook to store data in the contract
* @dev Can only be called by a hook
* @param key bytes32 - Slot to store data at
* @param data bytes calldata - Data to store
*/
function setHookData(bytes32 key, bytes calldata data) external;
/**
* @notice Get the data stored by a hook
* @param hook address - Address of the hook to retrieve data for
* @param key bytes32 - Slot to retrieve data from
* @return bytes memory - Data stored at the slot
*/
function getHookData(address hook, bytes32 key) external view returns (bytes memory);
/**
* @notice Check if an address is in the list of hooks
* @param addr address - Address to check
* @return bool - True if the address is a hook, false otherwise
*/
function isHook(address addr) external view returns (bool);
/**
* @notice Get the list of validation or execution hooks
* @param isValidation bool - True if the list of validation hooks should be returned, false otherwise
* @return hookList address[] memory - List of validation or exeuction hooks
*/
function listHooks(bool isValidation) external view returns (address[] memory hookList);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Errors} from '../libraries/Errors.sol';
/**
* @title SelfAuth
* @notice Abstract contract that allows only calls by the self contract
* @author https://getclave.io
*/
abstract contract SelfAuth {
modifier onlySelf() {
if (msg.sender != address(this)) {
revert Errors.NOT_FROM_SELF();
}
_;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
/**
* @title Interface of the manager contract for owners
* @author https://getclave.io
*/
interface IOwnerManager {
/**
* @notice Event emitted when a r1 owner is added
* @param pubKey bytes - r1 owner that has been added
*/
event R1AddOwner(bytes pubKey);
/**
* @notice Event emitted when a k1 owner is added
* @param addr address - k1 owner that has been added
*/
event K1AddOwner(address indexed addr);
/**
* @notice Event emitted when a r1 owner is removed
* @param pubKey bytes - r1 owner that has been removed
*/
event R1RemoveOwner(bytes pubKey);
/**
* @notice Event emitted when a k1 owner is removed
* @param addr address - k1 owner that has been removed
*/
event K1RemoveOwner(address indexed addr);
/**
* @notice Event emitted when all owners are cleared
*/
event ResetOwners();
/**
* @notice Adds a r1 owner to the list of r1 owners
* @dev Can only be called by self or a whitelisted module
* @dev Public Key length must be 64 bytes
* @param pubKey bytes calldata - Public key to add to the list of r1 owners
*/
function r1AddOwner(bytes calldata pubKey) external;
/**
* @notice Adds a k1 owner to the list of k1 owners
* @dev Can only be called by self or a whitelisted module
* @dev Address can not be the zero address
* @param addr address - Address to add to the list of k1 owners
*/
function k1AddOwner(address addr) external;
/**
* @notice Removes a r1 owner from the list of r1 owners
* @dev Can only be called by self or a whitelisted module
* @dev Can not remove the last r1 owner
* @param pubKey bytes calldata - Public key to remove from the list of r1 owners
*/
function r1RemoveOwner(bytes calldata pubKey) external;
/**
* @notice Removes a k1 owner from the list of k1 owners
* @dev Can only be called by self or a whitelisted module
* @param addr address - Address to remove from the list of k1 owners
*/
function k1RemoveOwner(address addr) external;
/**
* @notice Clears both r1 owners and k1 owners and adds an r1 owner
* @dev Can only be called by self or a whitelisted module
* @dev Public Key length must be 64 bytes
* @param pubKey bytes calldata - new r1 owner to add
*/
function resetOwners(bytes calldata pubKey) external;
/**
* @notice Checks if a public key is in the list of r1 owners
* @param pubKey bytes calldata - Public key to check
* @return bool - True if the public key is in the list, false otherwise
*/
function r1IsOwner(bytes calldata pubKey) external view returns (bool);
/**
* @notice Checks if an address is in the list of k1 owners
* @param addr address - Address to check
* @return bool - True if the address is in the list, false otherwise
*/
function k1IsOwner(address addr) external view returns (bool);
/**
* @notice Returns the list of r1 owners
* @return r1OwnerList bytes[] memory - Array of r1 owner public keys
*/
function r1ListOwners() external view returns (bytes[] memory r1OwnerList);
/**
* @notice Returns the list of k1 owners
* @return k1OwnerList address[] memory - Array of k1 owner addresses
*/
function k1ListOwners() external view returns (address[] memory k1OwnerList);
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
/**
* @title Manager contract for validators
* @author https://getclave.io
*/
interface IValidatorManager {
/**
* @notice Event emitted when a r1 validator is added
* @param validator address - Address of the added r1 validator
*/
event R1AddValidator(address indexed validator);
/**
* @notice Event emitted when a k1 validator is added
* @param validator address - Address of the added k1 validator
*/
event K1AddValidator(address indexed validator);
/**
* @notice Event emitted when a modular validator is added
* @param validator address - Address of the added modular validator
*/
event AddModuleValidator(address indexed validator);
/**
* @notice Event emitted when a r1 validator is removed
* @param validator address - Address of the removed r1 validator
*/
event R1RemoveValidator(address indexed validator);
/**
* @notice Event emitted when a k1 validator is removed
* @param validator address - Address of the removed k1 validator
*/
event K1RemoveValidator(address indexed validator);
/**
* @notice Event emitted when a modular validator is removed
* @param validator address - Address of the removed modular validator
*/
event RemoveModuleValidator(address indexed validator);
/**
* @notice Adds a validator to the list of r1 validators
* @dev Can only be called by self or a whitelisted module
* @param validator address - Address of the r1 validator to add
*/
function r1AddValidator(address validator) external;
/**
* @notice Adds a validator to the list of modular validators
* @dev Can only be called by self or a whitelisted module
* @param validator address - Address of the generic validator to add
* @param accountValidationKey bytes - data for the validator to use to validate the account
*/
function addModuleValidator(address validator, bytes memory accountValidationKey) external;
/**
* @notice Adds a validator to the list of k1 validators
* @dev Can only be called by self or a whitelisted module
* @param validator address - Address of the k1 validator to add
*/
function k1AddValidator(address validator) external;
/**
* @notice Removes a validator from the list of r1 validators
* @dev Can only be called by self or a whitelisted module
* @dev Can not remove the last validator
* @param validator address - Address of the validator to remove
*/
function r1RemoveValidator(address validator) external;
/**
* @notice Removes a validator from the list of k1 validators
* @dev Can only be called by self or a whitelisted module
* @param validator address - Address of the validator to remove
*/
function k1RemoveValidator(address validator) external;
/**
* @notice Removes a validator from the list of modular validators
* @dev Can only be called by self or a whitelisted module
* @param validator address - Address of the validator to remove
*/
function removeModuleValidator(address validator) external;
/**
* @notice Checks if an address is in the r1 validator list
* @param validator address -Address of the validator to check
* @return True if the address is a validator, false otherwise
*/
function r1IsValidator(address validator) external view returns (bool);
/**
* @notice Checks if an address is in the k1 validator list
* @param validator address - Address of the validator to check
* @return True if the address is a validator, false otherwise
*/
function k1IsValidator(address validator) external view returns (bool);
/**
* @notice Checks if an address is in the modular validator list
* @param validator address - Address of the validator to check
* @return True if the address is a validator, false otherwise
*/
function isModuleValidator(address validator) external view returns (bool);
/**
* @notice Returns the list of r1 validators
* @return validatorList address[] memory - Array of r1 validator addresses
*/
function r1ListValidators() external view returns (address[] memory validatorList);
/**
* @notice Returns the list of k1 validators
* @return validatorList address[] memory - Array of k1 validator addresses
*/
function k1ListValidators() external view returns (address[] memory validatorList);
/**
* @notice Returns the list of modular validators
* @return validatorList address[] memory - Array of modular validator addresses
*/
function listModuleValidators() external view returns (address[] memory validatorList);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (access/Ownable2Step.sol)
pragma solidity ^0.8.20;
import {Ownable} from "./Ownable.sol";
/**
* @dev Contract module which provides access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* This extension of the {Ownable} contract includes a two-step mechanism to transfer
* ownership, where the new owner must call {acceptOwnership} in order to replace the
* old one. This can help prevent common mistakes, such as transfers of ownership to
* incorrect accounts, or to contracts that are unable to interact with the
* permission system.
*
* The initial owner is specified at deployment time in the constructor for `Ownable`. This
* can later be changed with {transferOwnership} and {acceptOwnership}.
*
* This module is used through inheritance. It will make available all functions
* from parent (Ownable).
*/
abstract contract Ownable2Step is Ownable {
address private _pendingOwner;
event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);
/**
* @dev Returns the address of the pending owner.
*/
function pendingOwner() public view virtual returns (address) {
return _pendingOwner;
}
/**
* @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
* Can only be called by the current owner.
*
* Setting `newOwner` to the zero address is allowed; this can be used to cancel an initiated ownership transfer.
*/
function transferOwnership(address newOwner) public virtual override onlyOwner {
_pendingOwner = newOwner;
emit OwnershipTransferStarted(owner(), newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual override {
delete _pendingOwner;
super._transferOwnership(newOwner);
}
/**
* @dev The new owner accepts the ownership transfer.
*/
function acceptOwnership() public virtual {
address sender = _msgSender();
if (pendingOwner() != sender) {
revert OwnableUnauthorizedAccount(sender);
}
_transferOwnership(sender);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1271.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC-1271 standard signature validation method for
* contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
*/
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 OR Apache-2.0
pragma solidity >=0.7.6;
library ExcessivelySafeCall {
uint256 constant LOW_28_MASK =
0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
/// @notice Use when you _really_ really _really_ don't trust the called
/// contract. This prevents the called contract from causing reversion of
/// the caller in as many ways as we can.
/// @dev The main difference between this and a solidity low-level call is
/// that we limit the number of bytes that the callee can cause to be
/// copied to caller memory. This prevents stupid things like malicious
/// contracts returning 10,000,000 bytes causing a local OOG when copying
/// to memory.
/// @param _target The address to call
/// @param _gas The amount of gas to forward to the remote contract
/// @param _value The value in wei to send to the remote contract
/// @param _maxCopy The maximum number of bytes of returndata to copy
/// to memory.
/// @param _calldata The data to send to the remote contract
/// @return success and returndata, as `.call()`. Returndata is capped to
/// `_maxCopy` bytes.
function excessivelySafeCall(
address _target,
uint256 _gas,
uint256 _value,
uint16 _maxCopy,
bytes memory _calldata
) internal returns (bool, bytes memory) {
// set up for assembly call
uint256 _toCopy;
bool _success;
bytes memory _returnData = new bytes(_maxCopy);
// dispatch message to recipient
// by assembly calling "handle" function
// we call via assembly to avoid memcopying a very large returndata
// returned by a malicious contract
assembly {
_success := call(
_gas, // gas
_target, // recipient
_value, // ether value
add(_calldata, 0x20), // inloc
mload(_calldata), // inlen
0, // outloc
0 // outlen
)
// limit our copy to 256 bytes
_toCopy := returndatasize()
if gt(_toCopy, _maxCopy) {
_toCopy := _maxCopy
}
// Store the length of the copied bytes
mstore(_returnData, _toCopy)
// copy the bytes from returndata[0:_toCopy]
returndatacopy(add(_returnData, 0x20), 0, _toCopy)
}
return (_success, _returnData);
}
/// @notice Use when you _really_ really _really_ don't trust the called
/// contract. This prevents the called contract from causing reversion of
/// the caller in as many ways as we can.
/// @dev The main difference between this and a solidity low-level call is
/// that we limit the number of bytes that the callee can cause to be
/// copied to caller memory. This prevents stupid things like malicious
/// contracts returning 10,000,000 bytes causing a local OOG when copying
/// to memory.
/// @param _target The address to call
/// @param _gas The amount of gas to forward to the remote contract
/// @param _maxCopy The maximum number of bytes of returndata to copy
/// to memory.
/// @param _calldata The data to send to the remote contract
/// @return success and returndata, as `.call()`. Returndata is capped to
/// `_maxCopy` bytes.
function excessivelySafeStaticCall(
address _target,
uint256 _gas,
uint16 _maxCopy,
bytes memory _calldata
) internal view returns (bool, bytes memory) {
// set up for assembly call
uint256 _toCopy;
bool _success;
bytes memory _returnData = new bytes(_maxCopy);
// dispatch message to recipient
// by assembly calling "handle" function
// we call via assembly to avoid memcopying a very large returndata
// returned by a malicious contract
assembly {
_success := staticcall(
_gas, // gas
_target, // recipient
add(_calldata, 0x20), // inloc
mload(_calldata), // inlen
0, // outloc
0 // outlen
)
// limit our copy to 256 bytes
_toCopy := returndatasize()
if gt(_toCopy, _maxCopy) {
_toCopy := _maxCopy
}
// Store the length of the copied bytes
mstore(_returnData, _toCopy)
// copy the bytes from returndata[0:_toCopy]
returndatacopy(add(_returnData, 0x20), 0, _toCopy)
}
return (_success, _returnData);
}
/**
* @notice Swaps function selectors in encoded contract calls
* @dev Allows reuse of encoded calldata for functions with identical
* argument types but different names. It simply swaps out the first 4 bytes
* for the new selector. This function modifies memory in place, and should
* only be used with caution.
* @param _newSelector The new 4-byte selector
* @param _buf The encoded contract args
*/
function swapSelector(bytes4 _newSelector, bytes memory _buf)
internal
pure
{
require(_buf.length >= 4);
uint256 _mask = LOW_28_MASK;
assembly {
// load the first word of
let _word := mload(add(_buf, 0x20))
// mask out the top 4 bytes
// /x
_word := and(_word, _mask)
_word := or(_newSelector, _word)
mstore(add(_buf, 0x20), _word)
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC777Recipient.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC-777 Tokens Recipient standard as defined in the ERC.
*
* Accounts can be notified of {IERC777} tokens being sent to them by having a
* contract implement this interface (contract holders can be their own
* implementer) and registering it on the
* https://eips.ethereum.org/EIPS/eip-1820[ERC-1820 global registry].
*
* See {IERC1820Registry} and {IERC1820Implementer}.
*/
interface IERC777Recipient {
/**
* @dev Called by an {IERC777} token contract whenever tokens are being
* moved or created into a registered account (`to`). The type of operation
* is conveyed by `from` being the zero address or not.
*
* This call occurs _after_ the token contract's state is updated, so
* {IERC777-balanceOf}, etc., can be used to query the post-operation state.
*
* This function may revert to prevent the operation from being executed.
*/
function tokensReceived(
address operator,
address from,
address to,
uint256 amount,
bytes calldata userData,
bytes calldata operatorData
) external;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)
pragma solidity ^0.8.20;
/**
* @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 v5.0.0) (interfaces/IERC721Receiver.sol)
pragma solidity ^0.8.20;
import {IERC721Receiver} from "../token/ERC721/IERC721Receiver.sol";// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165Checker.sol)
pragma solidity ^0.8.20;
import {IERC165} from "./IERC165.sol";
/**
* @dev Library used to query support of an interface declared via {IERC165}.
*
* Note that these functions return the actual result of the query: they do not
* `revert` if an interface is not supported. It is up to the caller to decide
* what to do in these cases.
*/
library ERC165Checker {
// As per the ERC-165 spec, no interface should ever match 0xffffffff
bytes4 private constant INTERFACE_ID_INVALID = 0xffffffff;
/**
* @dev Returns true if `account` supports the {IERC165} interface.
*/
function supportsERC165(address account) internal view returns (bool) {
// Any contract that implements ERC-165 must explicitly indicate support of
// InterfaceId_ERC165 and explicitly indicate non-support of InterfaceId_Invalid
return
supportsERC165InterfaceUnchecked(account, type(IERC165).interfaceId) &&
!supportsERC165InterfaceUnchecked(account, INTERFACE_ID_INVALID);
}
/**
* @dev Returns true if `account` supports the interface defined by
* `interfaceId`. Support for {IERC165} itself is queried automatically.
*
* See {IERC165-supportsInterface}.
*/
function supportsInterface(address account, bytes4 interfaceId) internal view returns (bool) {
// query support of both ERC-165 as per the spec and support of _interfaceId
return supportsERC165(account) && supportsERC165InterfaceUnchecked(account, interfaceId);
}
/**
* @dev Returns a boolean array where each value corresponds to the
* interfaces passed in and whether they're supported or not. This allows
* you to batch check interfaces for a contract where your expectation
* is that some interfaces may not be supported.
*
* See {IERC165-supportsInterface}.
*/
function getSupportedInterfaces(
address account,
bytes4[] memory interfaceIds
) internal view returns (bool[] memory) {
// an array of booleans corresponding to interfaceIds and whether they're supported or not
bool[] memory interfaceIdsSupported = new bool[](interfaceIds.length);
// query support of ERC-165 itself
if (supportsERC165(account)) {
// query support of each interface in interfaceIds
for (uint256 i = 0; i < interfaceIds.length; i++) {
interfaceIdsSupported[i] = supportsERC165InterfaceUnchecked(account, interfaceIds[i]);
}
}
return interfaceIdsSupported;
}
/**
* @dev Returns true if `account` supports all the interfaces defined in
* `interfaceIds`. Support for {IERC165} itself is queried automatically.
*
* Batch-querying can lead to gas savings by skipping repeated checks for
* {IERC165} support.
*
* See {IERC165-supportsInterface}.
*/
function supportsAllInterfaces(address account, bytes4[] memory interfaceIds) internal view returns (bool) {
// query support of ERC-165 itself
if (!supportsERC165(account)) {
return false;
}
// query support of each interface in interfaceIds
for (uint256 i = 0; i < interfaceIds.length; i++) {
if (!supportsERC165InterfaceUnchecked(account, interfaceIds[i])) {
return false;
}
}
// all interfaces supported
return true;
}
/**
* @notice Query if a contract implements an interface, does not check ERC-165 support
* @param account The address of the contract to query for support of an interface
* @param interfaceId The interface identifier, as specified in ERC-165
* @return true if the contract at account indicates support of the interface with
* identifier interfaceId, false otherwise
* @dev Assumes that account contains a contract that supports ERC-165, otherwise
* the behavior of this method is undefined. This precondition can be checked
* with {supportsERC165}.
*
* Some precompiled contracts will falsely indicate support for a given interface, so caution
* should be exercised when using this function.
*
* Interface identification is specified in ERC-165.
*/
function supportsERC165InterfaceUnchecked(address account, bytes4 interfaceId) internal view returns (bool) {
// prepare call
bytes memory encodedParams = abi.encodeCall(IERC165.supportsInterface, (interfaceId));
// perform static call
bool success;
uint256 returnSize;
uint256 returnValue;
assembly ("memory-safe") {
success := staticcall(30000, account, add(encodedParams, 0x20), mload(encodedParams), 0x00, 0x20)
returnSize := returndatasize()
returnValue := mload(0x00)
}
return success && returnSize >= 0x20 && returnValue > 0;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC1155Receiver.sol)
pragma solidity ^0.8.20;
import {IERC1155Receiver} from "../token/ERC1155/IERC1155Receiver.sol";// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity ^0.8.20;
/**
* @title ERC-721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC-721 asset contracts.
*/
interface IERC721Receiver {
/**
* @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
* by `operator` from `from`, this function is called.
*
* It must return its Solidity selector to confirm the token transfer.
* If any other value is returned or the interface is not implemented by the recipient, the transfer will be
* reverted.
*
* The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
*/
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC1155/IERC1155Receiver.sol)
pragma solidity ^0.8.20;
import {IERC165} from "../../utils/introspection/IERC165.sol";
/**
* @dev Interface that must be implemented by smart contracts in order to receive
* ERC-1155 token transfers.
*/
interface IERC1155Receiver is IERC165 {
/**
* @dev Handles the receipt of a single ERC-1155 token type. This function is
* called at the end of a `safeTransferFrom` after the balance has been updated.
*
* NOTE: To accept the transfer, this must return
* `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
* (i.e. 0xf23a6e61, or its own function selector).
*
* @param operator The address which initiated the transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param id The ID of the token being transferred
* @param value The amount of tokens being transferred
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
*/
function onERC1155Received(
address operator,
address from,
uint256 id,
uint256 value,
bytes calldata data
) external returns (bytes4);
/**
* @dev Handles the receipt of a multiple ERC-1155 token types. This function
* is called at the end of a `safeBatchTransferFrom` after the balances have
* been updated.
*
* NOTE: To accept the transfer(s), this must return
* `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
* (i.e. 0xbc197c81, or its own function selector).
*
* @param operator The address which initiated the batch transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param ids An array containing ids of each token being transferred (order and length must match values array)
* @param values An array containing amounts of each token being transferred (order and length must match ids array)
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
*/
function onERC1155BatchReceived(
address operator,
address from,
uint256[] calldata ids,
uint256[] calldata values,
bytes calldata data
) external returns (bytes4);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/EIP712.sol)
pragma solidity ^0.8.20;
import {MessageHashUtils} from "@openzeppelin/contracts/utils/cryptography/MessageHashUtils.sol";
import {IERC5267} from "@openzeppelin/contracts/interfaces/IERC5267.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";
/**
* @dev https://eips.ethereum.org/EIPS/eip-712[EIP-712] is a standard for hashing and signing of typed structured data.
*
* The encoding scheme specified in the EIP requires a domain separator and a hash of the typed structured data, whose
* encoding is very generic and therefore its implementation in Solidity is not feasible, thus this contract
* does not implement the encoding itself. Protocols need to implement the type-specific encoding they need in order to
* produce the hash of their typed data using a combination of `abi.encode` and `keccak256`.
*
* This contract implements the EIP-712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
* scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
* ({_hashTypedDataV4}).
*
* The implementation of the domain separator was designed to be as efficient as possible while still properly updating
* the chain id to protect against replay attacks on an eventual fork of the chain.
*
* NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
* https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
*
* NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain
* separator of the implementation contract. This will cause the {_domainSeparatorV4} function to always rebuild the
* separator from the immutable values, which is cheaper than accessing a cached version in cold storage.
*/
abstract contract EIP712Upgradeable is Initializable, IERC5267 {
bytes32 private constant TYPE_HASH =
keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
/// @custom:storage-location erc7201:openzeppelin.storage.EIP712
struct EIP712Storage {
/// @custom:oz-renamed-from _HASHED_NAME
bytes32 _hashedName;
/// @custom:oz-renamed-from _HASHED_VERSION
bytes32 _hashedVersion;
string _name;
string _version;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.EIP712")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant EIP712StorageLocation = 0xa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100;
function _getEIP712Storage() private pure returns (EIP712Storage storage $) {
assembly {
$.slot := EIP712StorageLocation
}
}
/**
* @dev Initializes the domain separator and parameter caches.
*
* The meaning of `name` and `version` is specified in
* https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP-712]:
*
* - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
* - `version`: the current major version of the signing domain.
*
* NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
* contract upgrade].
*/
function __EIP712_init(string memory name, string memory version) internal onlyInitializing {
__EIP712_init_unchained(name, version);
}
function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {
EIP712Storage storage $ = _getEIP712Storage();
$._name = name;
$._version = version;
// Reset prior values in storage if upgrading
$._hashedName = 0;
$._hashedVersion = 0;
}
/**
* @dev Returns the domain separator for the current chain.
*/
function _domainSeparatorV4() internal view returns (bytes32) {
return _buildDomainSeparator();
}
function _buildDomainSeparator() private view returns (bytes32) {
return keccak256(abi.encode(TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash(), block.chainid, address(this)));
}
/**
* @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
* function returns the hash of the fully encoded EIP712 message for this domain.
*
* This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
*
* ```solidity
* bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
* keccak256("Mail(address to,string contents)"),
* mailTo,
* keccak256(bytes(mailContents))
* )));
* address signer = ECDSA.recover(digest, signature);
* ```
*/
function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
return MessageHashUtils.toTypedDataHash(_domainSeparatorV4(), structHash);
}
/**
* @dev See {IERC-5267}.
*/
function eip712Domain()
public
view
virtual
returns (
bytes1 fields,
string memory name,
string memory version,
uint256 chainId,
address verifyingContract,
bytes32 salt,
uint256[] memory extensions
)
{
EIP712Storage storage $ = _getEIP712Storage();
// If the hashed name and version in storage are non-zero, the contract hasn't been properly initialized
// and the EIP712 domain is not reliable, as it will be missing name and version.
require($._hashedName == 0 && $._hashedVersion == 0, "EIP712: Uninitialized");
return (
hex"0f", // 01111
_EIP712Name(),
_EIP712Version(),
block.chainid,
address(this),
bytes32(0),
new uint256[](0)
);
}
/**
* @dev The name parameter for the EIP712 domain.
*
* NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs
* are a concern.
*/
function _EIP712Name() internal view virtual returns (string memory) {
EIP712Storage storage $ = _getEIP712Storage();
return $._name;
}
/**
* @dev The version parameter for the EIP712 domain.
*
* NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs
* are a concern.
*/
function _EIP712Version() internal view virtual returns (string memory) {
EIP712Storage storage $ = _getEIP712Storage();
return $._version;
}
/**
* @dev The hash of the name parameter for the EIP712 domain.
*
* NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Name` instead.
*/
function _EIP712NameHash() internal view returns (bytes32) {
EIP712Storage storage $ = _getEIP712Storage();
string memory name = _EIP712Name();
if (bytes(name).length > 0) {
return keccak256(bytes(name));
} else {
// If the name is empty, the contract may have been upgraded without initializing the new storage.
// We return the name hash in storage if non-zero, otherwise we assume the name is empty by design.
bytes32 hashedName = $._hashedName;
if (hashedName != 0) {
return hashedName;
} else {
return keccak256("");
}
}
}
/**
* @dev The hash of the version parameter for the EIP712 domain.
*
* NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Version` instead.
*/
function _EIP712VersionHash() internal view returns (bytes32) {
EIP712Storage storage $ = _getEIP712Storage();
string memory version = _EIP712Version();
if (bytes(version).length > 0) {
return keccak256(bytes(version));
} else {
// If the version is empty, the contract may have been upgraded without initializing the new storage.
// We return the version hash in storage if non-zero, otherwise we assume the version is empty by design.
bytes32 hashedVersion = $._hashedVersion;
if (hashedVersion != 0) {
return hashedVersion;
} else {
return keccak256("");
}
}
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {BOOTLOADER_FORMAL_ADDRESS} from '@matterlabs/zksync-contracts/l2/system-contracts/Constants.sol';
import {Errors} from '../libraries/Errors.sol';
/**
* @title BootloaderAuth
* @notice Abstract contract that allows only calls from bootloader
* @author https://getclave.io
*/
abstract contract BootloaderAuth {
modifier onlyBootloader() {
if (msg.sender != BOOTLOADER_FORMAL_ADDRESS) {
revert Errors.NOT_FROM_BOOTLOADER();
}
_;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Errors} from '../libraries/Errors.sol';
/**
* @title ModuleAuth
* @notice Abstract contract that allows only calls from modules
* @author https://getclave.io
*/
abstract contract ModuleAuth {
function _isModule(address addr) internal view virtual returns (bool);
modifier onlyModule() {
if (!_isModule(msg.sender)) {
revert Errors.NOT_FROM_MODULE();
}
_;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {Errors} from '../libraries/Errors.sol';
/**
* @title HookAuth
* @notice Abstract contract that allows only calls from hooks
* @author https://getclave.io
*/
abstract contract HookAuth {
function _isHook(address addr) internal view virtual returns (bool);
modifier onlyHook() {
if (!_isHook(msg.sender)) {
revert Errors.NOT_FROM_HOOK();
}
_;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
import {AGWStorage} from '../libraries/AGWStorage.sol';
import {BytesLinkedList, AddressLinkedList} from '../libraries/LinkedList.sol';
import {Errors} from '../libraries/Errors.sol';
import {Auth} from '../auth/Auth.sol';
import {IAGWAccount} from '../interfaces/IAGWAccount.sol';
import {IOwnerManager} from '../interfaces/IOwnerManager.sol';
/**
* @title Manager contract for owners
* @notice Abstract contract for managing the owners of the account
* @dev R1 Owners are 64 byte secp256r1 public keys
* @dev K1 Owners are secp256k1 addresses
* @dev Owners are stored in a linked list
* @author https://getclave.io
*/
abstract contract OwnerManager is IOwnerManager, Auth {
// Helper library for bytes to bytes mappings
using BytesLinkedList for mapping(bytes => bytes);
// Helper library for address to address mappings
using AddressLinkedList for mapping(address => address);
/// @inheritdoc IOwnerManager
function r1AddOwner(bytes calldata pubKey) external override onlySelfOrModule {
_r1AddOwner(pubKey);
}
/// @inheritdoc IOwnerManager
function k1AddOwner(address addr) external override onlySelfOrModule {
_k1AddOwner(addr);
}
/// @inheritdoc IOwnerManager
function r1RemoveOwner(bytes calldata pubKey) external override onlySelfOrModule {
_r1RemoveOwner(pubKey);
}
/// @inheritdoc IOwnerManager
function k1RemoveOwner(address addr) external override onlySelfOrModule {
_k1RemoveOwner(addr);
}
/// @inheritdoc IOwnerManager
function resetOwners(bytes calldata pubKey) external override onlySelfOrModule {
_r1ClearOwners();
_k1ClearOwners();
emit ResetOwners();
_r1AddOwner(pubKey);
}
/// @inheritdoc IOwnerManager
function r1IsOwner(bytes calldata pubKey) external view override returns (bool) {
return _r1IsOwner(pubKey);
}
/// @inheritdoc IOwnerManager
function k1IsOwner(address addr) external view override returns (bool) {
return _k1IsOwner(addr);
}
/// @inheritdoc IOwnerManager
function r1ListOwners() external view override returns (bytes[] memory r1OwnerList) {
r1OwnerList = _r1OwnersLinkedList().list();
}
/// @inheritdoc IOwnerManager
function k1ListOwners() external view override returns (address[] memory k1OwnerList) {
k1OwnerList = _k1OwnersLinkedList().list();
}
function _r1AddOwner(bytes calldata pubKey) internal {
if (pubKey.length != 64) {
revert Errors.INVALID_PUBKEY_LENGTH();
}
_r1OwnersLinkedList().add(pubKey);
emit R1AddOwner(pubKey);
}
function _k1AddOwner(address addr) internal {
_k1OwnersLinkedList().add(addr);
emit K1AddOwner(addr);
}
function _r1RemoveOwner(bytes calldata pubKey) internal {
_r1OwnersLinkedList().remove(pubKey);
emit R1RemoveOwner(pubKey);
}
function _k1RemoveOwner(address addr) internal {
_k1OwnersLinkedList().remove(addr);
// The wallet should have at least one owner
if (_k1OwnersLinkedList().isEmpty()) {
revert Errors.EMPTY_OWNERS();
}
emit K1RemoveOwner(addr);
}
function _r1IsOwner(bytes calldata pubKey) internal view returns (bool) {
return _r1OwnersLinkedList().exists(pubKey);
}
function _k1IsOwner(address addr) internal view returns (bool) {
return _k1OwnersLinkedList().exists(addr);
}
function _r1OwnersLinkedList()
internal
view
returns (mapping(bytes => bytes) storage r1Owners)
{
r1Owners = AGWStorage.layout().r1Owners;
}
function _k1OwnersLinkedList()
internal
view
returns (mapping(address => address) storage k1Owners)
{
k1Owners = AGWStorage.layout().k1Owners;
}
function _r1ClearOwners() private {
_r1OwnersLinkedList().clear();
}
function _k1ClearOwners() private {
_k1OwnersLinkedList().clear();
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.24;
import { ERC165Checker } from "@openzeppelin/contracts/utils/introspection/ERC165Checker.sol";
import { Auth } from "../auth/Auth.sol";
import { Errors } from "../libraries/Errors.sol";
import {AGWStorage} from '../libraries/AGWStorage.sol';
import { AddressLinkedList } from "../libraries/LinkedList.sol";
import { IR1Validator, IK1Validator } from "../interfaces/IValidator.sol";
import { IValidatorManager } from "../interfaces/IValidatorManager.sol";
import { IModuleValidator } from "../interfaces/IModuleValidator.sol";
/**
* @title Manager contract for validators
* @notice Abstract contract for managing the validators of the account
* @dev Validators are stored in a linked list
* @author https://getclave.io
*/
abstract contract ValidatorManager is IValidatorManager, Auth {
// Helper library for address to address mappings
using AddressLinkedList for mapping(address => address);
// Interface helper library
using ERC165Checker for address;
/// @inheritdoc IValidatorManager
function r1AddValidator(address validator) external override onlySelfOrModule {
_r1AddValidator(validator);
}
function addModuleValidator(address validator, bytes memory initialAccountValidationKey) external onlySelfOrModule {
_addModuleValidator(validator, initialAccountValidationKey);
}
/// @inheritdoc IValidatorManager
function k1AddValidator(address validator) external override onlySelfOrModule {
_k1AddValidator(validator);
}
/// @inheritdoc IValidatorManager
function r1RemoveValidator(address validator) external override onlySelfOrModule {
_r1RemoveValidator(validator);
}
/// @inheritdoc IValidatorManager
function k1RemoveValidator(address validator) external override onlySelfOrModule {
_k1RemoveValidator(validator);
}
///@inheritdoc IValidatorManager
function removeModuleValidator(address validator) external onlySelfOrModule {
_removeModuleValidator(validator);
}
/// @inheritdoc IValidatorManager
function r1IsValidator(address validator) external view override returns (bool) {
return _r1IsValidator(validator);
}
/// @inheritdoc IValidatorManager
function k1IsValidator(address validator) external view override returns (bool) {
return _k1IsValidator(validator);
}
/// @inheritdoc IValidatorManager
function isModuleValidator(address validator) external view override returns (bool) {
return _isModuleValidator(validator);
}
/// @inheritdoc IValidatorManager
function r1ListValidators() external view override returns (address[] memory validatorList) {
validatorList = _r1ValidatorsLinkedList().list();
}
/// @inheritdoc IValidatorManager
function k1ListValidators() external view override returns (address[] memory validatorList) {
validatorList = _k1ValidatorsLinkedList().list();
}
/// @inheritdoc IValidatorManager
function listModuleValidators() external view override returns (address[] memory validatorList) {
validatorList = _moduleValidatorsLinkedList().list();
}
function _r1AddValidator(address validator) internal {
if (!_supportsR1(validator)) {
revert Errors.VALIDATOR_ERC165_FAIL();
}
_r1ValidatorsLinkedList().add(validator);
emit R1AddValidator(validator);
}
function _addModuleValidator(address validator, bytes memory accountValidationKey) internal {
if (!_supportsModuleValidator(validator)) {
revert Errors.VALIDATOR_ERC165_FAIL();
}
_moduleValidatorsLinkedList().add(validator);
IModuleValidator(validator).addValidationKey(accountValidationKey);
emit AddModuleValidator(validator);
}
function _k1AddValidator(address validator) internal {
if (!_supportsK1(validator)) {
revert Errors.VALIDATOR_ERC165_FAIL();
}
_k1ValidatorsLinkedList().add(validator);
emit K1AddValidator(validator);
}
function _r1RemoveValidator(address validator) internal {
_r1ValidatorsLinkedList().remove(validator);
emit R1RemoveValidator(validator);
}
function _k1RemoveValidator(address validator) internal {
_k1ValidatorsLinkedList().remove(validator);
// At least one validator must be present
if (_k1ValidatorsLinkedList().isEmpty()) {
revert Errors.EMPTY_VALIDATORS();
}
emit K1RemoveValidator(validator);
}
function _removeModuleValidator(address validator) internal {
_moduleValidatorsLinkedList().remove(validator);
emit RemoveModuleValidator(validator);
}
function _r1IsValidator(address validator) internal view returns (bool) {
return _r1ValidatorsLinkedList().exists(validator);
}
function _isModuleValidator(address validator) internal view returns (bool) {
return _moduleValidatorsLinkedList().exists(validator);
}
function _k1IsValidator(address validator) internal view returns (bool) {
return _k1ValidatorsLinkedList().exists(validator);
}
function _supportsR1(address validator) internal view returns (bool) {
return validator.supportsInterface(type(IR1Validator).interfaceId);
}
function _supportsK1(address validator) internal view returns (bool) {
return validator.supportsInterface(type(IK1Validator).interfaceId);
}
function _supportsModuleValidator(address validator) internal view returns (bool) {
return validator.supportsInterface(type(IModuleValidator).interfaceId);
}
function _r1ValidatorsLinkedList()
private
view
returns (mapping(address => address) storage r1Validators)
{
r1Validators = AGWStorage.layout().r1Validators;
}
function _moduleValidatorsLinkedList()
private
view
returns (mapping(address => address) storage moduleValidators)
{
moduleValidators = AGWStorage.layout().moduleValidators;
}
function _k1ValidatorsLinkedList()
private
view
returns (mapping(address => address) storage k1Validators)
{
k1Validators = AGWStorage.layout().k1Validators;
}
}// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.24;
import {OperationType} from './IValidator.sol';
/**
* @title Modular validator interface for native AA
* @dev Add signature to module or validate existing signatures for acccount
*/
interface IModuleValidator {
function handleValidation(OperationType operationType, bytes32 signedHash, bytes memory signature) external view returns (bool);
function addValidationKey(bytes memory key) external returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IAccountCodeStorage {
function storeAccountConstructingCodeHash(address _address, bytes32 _hash) external;
function storeAccountConstructedCodeHash(address _address, bytes32 _hash) external;
function markAccountCodeHashAsConstructed(address _address) external;
function getRawCodeHash(address _address) external view returns (bytes32 codeHash);
function getCodeHash(uint256 _input) external view returns (bytes32 codeHash);
function getCodeSize(uint256 _input) external view returns (uint256 codeSize);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @author Matter Labs
* @dev Interface of the nonce holder contract -- a contract used by the system to ensure
* that there is always a unique identifier for a transaction with a particular account (we call it nonce).
* In other words, the pair of (address, nonce) should always be unique.
* @dev Custom accounts should use methods of this contract to store nonces or other possible unique identifiers
* for the transaction.
*/
interface INonceHolder {
event ValueSetUnderNonce(address indexed accountAddress, uint256 indexed key, uint256 value);
/// @dev Returns the current minimal nonce for account.
function getMinNonce(address _address) external view returns (uint256);
/// @dev Returns the raw version of the current minimal nonce
/// (equal to minNonce + 2^128 * deployment nonce).
function getRawNonce(address _address) external view returns (uint256);
/// @dev Increases the minimal nonce for the msg.sender.
function increaseMinNonce(uint256 _value) external returns (uint256);
/// @dev Sets the nonce value `key` as used.
function setValueUnderNonce(uint256 _key, uint256 _value) external;
/// @dev Gets the value stored inside a custom nonce.
function getValueUnderNonce(uint256 _key) external view returns (uint256);
/// @dev A convenience method to increment the minimal nonce if it is equal
/// to the `_expectedNonce`.
function incrementMinNonceIfEquals(uint256 _expectedNonce) external;
/// @dev Returns the deployment nonce for the accounts used for CREATE opcode.
function getDeploymentNonce(address _address) external view returns (uint256);
/// @dev Increments the deployment nonce for the account and returns the previous one.
function incrementDeploymentNonce(address _address) external returns (uint256);
/// @dev Determines whether a certain nonce has been already used for an account.
function validateNonceUsage(address _address, uint256 _key, bool _shouldBeUsed) external view;
/// @dev Returns whether a nonce has been used for an account.
function isNonceUsed(address _address, uint256 _nonce) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./interfaces/IBootloaderUtilities.sol";
import "./libraries/TransactionHelper.sol";
import "./libraries/RLPEncoder.sol";
import "./libraries/EfficientCall.sol";
/**
* @author Matter Labs
* @notice A contract that provides some utility methods for the bootloader
* that is very hard to write in Yul.
*/
contract BootloaderUtilities is IBootloaderUtilities {
using TransactionHelper for *;
/// @notice Calculates the canonical transaction hash and the recommended transaction hash.
/// @param _transaction The transaction.
/// @return txHash and signedTxHash of the transaction, i.e. the transaction hash to be used in the explorer and commits to all
/// the fields of the transaction and the recommended hash to be signed for this transaction.
/// @dev txHash must be unique for all transactions.
function getTransactionHashes(
Transaction calldata _transaction
) external view override returns (bytes32 txHash, bytes32 signedTxHash) {
signedTxHash = _transaction.encodeHash();
if (_transaction.txType == EIP_712_TX_TYPE) {
txHash = keccak256(bytes.concat(signedTxHash, EfficientCall.keccak(_transaction.signature)));
} else if (_transaction.txType == LEGACY_TX_TYPE) {
txHash = encodeLegacyTransactionHash(_transaction);
} else if (_transaction.txType == EIP_1559_TX_TYPE) {
txHash = encodeEIP1559TransactionHash(_transaction);
} else if (_transaction.txType == EIP_2930_TX_TYPE) {
txHash = encodeEIP2930TransactionHash(_transaction);
} else {
revert("Unsupported tx type");
}
}
/// @notice Calculates the hash for a legacy transaction.
/// @param _transaction The legacy transaction.
/// @return txHash The hash of the transaction.
function encodeLegacyTransactionHash(Transaction calldata _transaction) internal view returns (bytes32 txHash) {
// Hash of legacy transactions are encoded as one of the:
// - RLP(nonce, gasPrice, gasLimit, to, value, data, chainId, 0, 0)
// - RLP(nonce, gasPrice, gasLimit, to, value, data)
//
// In this RLP encoding, only the first one above list appears, so we encode each element
// inside list and then concatenate the length of all elements with them.
bytes memory encodedNonce = RLPEncoder.encodeUint256(_transaction.nonce);
// Encode `gasPrice` and `gasLimit` together to prevent "stack too deep error".
bytes memory encodedGasParam;
{
bytes memory encodedGasPrice = RLPEncoder.encodeUint256(_transaction.maxFeePerGas);
bytes memory encodedGasLimit = RLPEncoder.encodeUint256(_transaction.gasLimit);
encodedGasParam = bytes.concat(encodedGasPrice, encodedGasLimit);
}
bytes memory encodedTo = RLPEncoder.encodeAddress(address(uint160(_transaction.to)));
bytes memory encodedValue = RLPEncoder.encodeUint256(_transaction.value);
// Encode only the length of the transaction data, and not the data itself,
// so as not to copy to memory a potentially huge transaction data twice.
bytes memory encodedDataLength;
{
// Safe cast, because the length of the transaction data can't be so large.
uint64 txDataLen = uint64(_transaction.data.length);
if (txDataLen != 1) {
// If the length is not equal to one, then only using the length can it be encoded definitely.
encodedDataLength = RLPEncoder.encodeNonSingleBytesLen(txDataLen);
} else if (_transaction.data[0] >= 0x80) {
// If input is a byte in [0x80, 0xff] range, RLP encoding will concatenates 0x81 with the byte.
encodedDataLength = hex"81";
}
// Otherwise the length is not encoded at all.
}
bytes memory rEncoded;
{
uint256 rInt = uint256(bytes32(_transaction.signature[0:32]));
rEncoded = RLPEncoder.encodeUint256(rInt);
}
bytes memory sEncoded;
{
uint256 sInt = uint256(bytes32(_transaction.signature[32:64]));
sEncoded = RLPEncoder.encodeUint256(sInt);
}
bytes memory vEncoded;
{
uint256 vInt = uint256(uint8(_transaction.signature[64]));
require(vInt == 27 || vInt == 28, "Invalid v value");
// If the `chainId` is specified in the transaction, then the `v` value is encoded as
// `35 + y + 2 * chainId == vInt + 8 + 2 * chainId`, where y - parity bit (see EIP-155).
if (_transaction.reserved[0] != 0) {
vInt += 8 + block.chainid * 2;
}
vEncoded = RLPEncoder.encodeUint256(vInt);
}
bytes memory encodedListLength;
unchecked {
uint256 listLength = encodedNonce.length +
encodedGasParam.length +
encodedTo.length +
encodedValue.length +
encodedDataLength.length +
_transaction.data.length +
rEncoded.length +
sEncoded.length +
vEncoded.length;
// Safe cast, because the length of the list can't be so large.
encodedListLength = RLPEncoder.encodeListLen(uint64(listLength));
}
return
keccak256(
bytes.concat(
encodedListLength,
encodedNonce,
encodedGasParam,
encodedTo,
encodedValue,
encodedDataLength,
_transaction.data,
vEncoded,
rEncoded,
sEncoded
)
);
}
/// @notice Calculates the hash for an EIP2930 transaction.
/// @param _transaction The EIP2930 transaction.
/// @return txHash The hash of the transaction.
function encodeEIP2930TransactionHash(Transaction calldata _transaction) internal view returns (bytes32) {
// Encode all fixed-length params to avoid "stack too deep error"
bytes memory encodedFixedLengthParams;
{
bytes memory encodedChainId = RLPEncoder.encodeUint256(block.chainid);
bytes memory encodedNonce = RLPEncoder.encodeUint256(_transaction.nonce);
bytes memory encodedGasPrice = RLPEncoder.encodeUint256(_transaction.maxFeePerGas);
bytes memory encodedGasLimit = RLPEncoder.encodeUint256(_transaction.gasLimit);
bytes memory encodedTo = RLPEncoder.encodeAddress(address(uint160(_transaction.to)));
bytes memory encodedValue = RLPEncoder.encodeUint256(_transaction.value);
encodedFixedLengthParams = bytes.concat(
encodedChainId,
encodedNonce,
encodedGasPrice,
encodedGasLimit,
encodedTo,
encodedValue
);
}
// Encode only the length of the transaction data, and not the data itself,
// so as not to copy to memory a potentially huge transaction data twice.
bytes memory encodedDataLength;
{
// Safe cast, because the length of the transaction data can't be so large.
uint64 txDataLen = uint64(_transaction.data.length);
if (txDataLen != 1) {
// If the length is not equal to one, then only using the length can it be encoded definitely.
encodedDataLength = RLPEncoder.encodeNonSingleBytesLen(txDataLen);
} else if (_transaction.data[0] >= 0x80) {
// If input is a byte in [0x80, 0xff] range, RLP encoding will concatenates 0x81 with the byte.
encodedDataLength = hex"81";
}
// Otherwise the length is not encoded at all.
}
// On zkSync, access lists are always zero length (at least for now).
bytes memory encodedAccessListLength = RLPEncoder.encodeListLen(0);
bytes memory rEncoded;
{
uint256 rInt = uint256(bytes32(_transaction.signature[0:32]));
rEncoded = RLPEncoder.encodeUint256(rInt);
}
bytes memory sEncoded;
{
uint256 sInt = uint256(bytes32(_transaction.signature[32:64]));
sEncoded = RLPEncoder.encodeUint256(sInt);
}
bytes memory vEncoded;
{
uint256 vInt = uint256(uint8(_transaction.signature[64]));
require(vInt == 27 || vInt == 28, "Invalid v value");
vEncoded = RLPEncoder.encodeUint256(vInt - 27);
}
bytes memory encodedListLength;
unchecked {
uint256 listLength = encodedFixedLengthParams.length +
encodedDataLength.length +
_transaction.data.length +
encodedAccessListLength.length +
rEncoded.length +
sEncoded.length +
vEncoded.length;
// Safe cast, because the length of the list can't be so large.
encodedListLength = RLPEncoder.encodeListLen(uint64(listLength));
}
return
keccak256(
bytes.concat(
"\x01",
encodedListLength,
encodedFixedLengthParams,
encodedDataLength,
_transaction.data,
encodedAccessListLength,
vEncoded,
rEncoded,
sEncoded
)
);
}
/// @notice Calculates the hash for an EIP1559 transaction.
/// @param _transaction The legacy transaction.
/// @return txHash The hash of the transaction.
function encodeEIP1559TransactionHash(Transaction calldata _transaction) internal view returns (bytes32) {
// The formula for hash of EIP1559 transaction in the original proposal:
// https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md
// Encode all fixed-length params to avoid "stack too deep error"
bytes memory encodedFixedLengthParams;
{
bytes memory encodedChainId = RLPEncoder.encodeUint256(block.chainid);
bytes memory encodedNonce = RLPEncoder.encodeUint256(_transaction.nonce);
bytes memory encodedMaxPriorityFeePerGas = RLPEncoder.encodeUint256(_transaction.maxPriorityFeePerGas);
bytes memory encodedMaxFeePerGas = RLPEncoder.encodeUint256(_transaction.maxFeePerGas);
bytes memory encodedGasLimit = RLPEncoder.encodeUint256(_transaction.gasLimit);
bytes memory encodedTo = RLPEncoder.encodeAddress(address(uint160(_transaction.to)));
bytes memory encodedValue = RLPEncoder.encodeUint256(_transaction.value);
encodedFixedLengthParams = bytes.concat(
encodedChainId,
encodedNonce,
encodedMaxPriorityFeePerGas,
encodedMaxFeePerGas,
encodedGasLimit,
encodedTo,
encodedValue
);
}
// Encode only the length of the transaction data, and not the data itself,
// so as not to copy to memory a potentially huge transaction data twice.
bytes memory encodedDataLength;
{
// Safe cast, because the length of the transaction data can't be so large.
uint64 txDataLen = uint64(_transaction.data.length);
if (txDataLen != 1) {
// If the length is not equal to one, then only using the length can it be encoded definitely.
encodedDataLength = RLPEncoder.encodeNonSingleBytesLen(txDataLen);
} else if (_transaction.data[0] >= 0x80) {
// If input is a byte in [0x80, 0xff] range, RLP encoding will concatenates 0x81 with the byte.
encodedDataLength = hex"81";
}
// Otherwise the length is not encoded at all.
}
// On zkSync, access lists are always zero length (at least for now).
bytes memory encodedAccessListLength = RLPEncoder.encodeListLen(0);
bytes memory rEncoded;
{
uint256 rInt = uint256(bytes32(_transaction.signature[0:32]));
rEncoded = RLPEncoder.encodeUint256(rInt);
}
bytes memory sEncoded;
{
uint256 sInt = uint256(bytes32(_transaction.signature[32:64]));
sEncoded = RLPEncoder.encodeUint256(sInt);
}
bytes memory vEncoded;
{
uint256 vInt = uint256(uint8(_transaction.signature[64]));
require(vInt == 27 || vInt == 28, "Invalid v value");
vEncoded = RLPEncoder.encodeUint256(vInt - 27);
}
bytes memory encodedListLength;
unchecked {
uint256 listLength = encodedFixedLengthParams.length +
encodedDataLength.length +
_transaction.data.length +
encodedAccessListLength.length +
rEncoded.length +
sEncoded.length +
vEncoded.length;
// Safe cast, because the length of the list can't be so large.
encodedListLength = RLPEncoder.encodeListLen(uint64(listLength));
}
return
keccak256(
bytes.concat(
"\x02",
encodedListLength,
encodedFixedLengthParams,
encodedDataLength,
_transaction.data,
encodedAccessListLength,
vEncoded,
rEncoded,
sEncoded
)
);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IKnownCodesStorage {
event MarkedAsKnown(bytes32 indexed bytecodeHash, bool indexed sendBytecodeToL1);
function markFactoryDeps(bool _shouldSendToL1, bytes32[] calldata _hashes) external;
function markBytecodeAsPublished(
bytes32 _bytecodeHash,
bytes32 _l1PreimageHash,
uint256 _l1PreimageBytesLen
) external;
function getMarker(bytes32 _hash) external view returns (uint256);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
struct ImmutableData {
uint256 index;
bytes32 value;
}
interface IImmutableSimulator {
function getImmutable(address _dest, uint256 _index) external view returns (bytes32);
function setImmutables(address _dest, ImmutableData[] calldata _immutables) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IContractDeployer {
/// @notice Defines the version of the account abstraction protocol
/// that a contract claims to follow.
/// - `None` means that the account is just a contract and it should never be interacted
/// with as a custom account
/// - `Version1` means that the account follows the first version of the account abstraction protocol
enum AccountAbstractionVersion {
None,
Version1
}
/// @notice Defines the nonce ordering used by the account
/// - `Sequential` means that it is expected that the nonces are monotonic and increment by 1
/// at a time (the same as EOAs).
/// - `Arbitrary` means that the nonces for the accounts can be arbitrary. The operator
/// should serve the transactions from such an account on a first-come-first-serve basis.
/// @dev This ordering is more of a suggestion to the operator on how the AA expects its transactions
/// to be processed and is not considered as a system invariant.
enum AccountNonceOrdering {
Sequential,
Arbitrary
}
struct AccountInfo {
AccountAbstractionVersion supportedAAVersion;
AccountNonceOrdering nonceOrdering;
}
event ContractDeployed(
address indexed deployerAddress,
bytes32 indexed bytecodeHash,
address indexed contractAddress
);
event AccountNonceOrderingUpdated(address indexed accountAddress, AccountNonceOrdering nonceOrdering);
event AccountVersionUpdated(address indexed accountAddress, AccountAbstractionVersion aaVersion);
function getNewAddressCreate2(
address _sender,
bytes32 _bytecodeHash,
bytes32 _salt,
bytes calldata _input
) external view returns (address newAddress);
function getNewAddressCreate(address _sender, uint256 _senderNonce) external pure returns (address newAddress);
function create2(
bytes32 _salt,
bytes32 _bytecodeHash,
bytes calldata _input
) external payable returns (address newAddress);
function create2Account(
bytes32 _salt,
bytes32 _bytecodeHash,
bytes calldata _input,
AccountAbstractionVersion _aaVersion
) external payable returns (address newAddress);
/// @dev While the `_salt` parameter is not used anywhere here,
/// it is still needed for consistency between `create` and
/// `create2` functions (required by the compiler).
function create(
bytes32 _salt,
bytes32 _bytecodeHash,
bytes calldata _input
) external payable returns (address newAddress);
/// @dev While `_salt` is never used here, we leave it here as a parameter
/// for the consistency with the `create` function.
function createAccount(
bytes32 _salt,
bytes32 _bytecodeHash,
bytes calldata _input,
AccountAbstractionVersion _aaVersion
) external payable returns (address newAddress);
/// @notice Returns the information about a certain AA.
function getAccountInfo(address _address) external view returns (AccountInfo memory info);
/// @notice Can be called by an account to update its account version
function updateAccountVersion(AccountAbstractionVersion _version) external;
/// @notice Can be called by an account to update its nonce ordering
function updateNonceOrdering(AccountNonceOrdering _nonceOrdering) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IL1Messenger {
// Possibly in the future we will be able to track the messages sent to L1 with
// some hooks in the VM. For now, it is much easier to track them with L2 events.
event L1MessageSent(address indexed _sender, bytes32 indexed _hash, bytes _message);
function sendToL1(bytes memory _message) external returns (bytes32);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @author Matter Labs
* @notice Contract that stores some of the context variables, that may be either
* block-scoped, tx-scoped or system-wide.
*/
interface ISystemContext {
function chainId() external view returns (uint256);
function origin() external view returns (address);
function gasPrice() external view returns (uint256);
function blockGasLimit() external view returns (uint256);
function coinbase() external view returns (address);
function difficulty() external view returns (uint256);
function baseFee() external view returns (uint256);
function blockHash(uint256 _block) external view returns (bytes32);
function getBlockHashEVM(uint256 _block) external view returns (bytes32);
function getBlockNumberAndTimestamp() external view returns (uint256 blockNumber, uint256 blockTimestamp);
// Note, that for now, the implementation of the bootloader allows this variables to
// be incremented multiple times inside a block, so it should not relied upon right now.
function getBlockNumber() external view returns (uint256);
function getBlockTimestamp() external view returns (uint256);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IEthToken {
function balanceOf(uint256) external view returns (uint256);
function transferFromTo(address _from, address _to, uint256 _amount) external;
function totalSupply() external view returns (uint256);
function name() external pure returns (string memory);
function symbol() external pure returns (string memory);
function decimals() external pure returns (uint8);
function mint(address _account, uint256 _amount) external;
function withdraw(address _l1Receiver) external payable;
event Mint(address indexed account, uint256 amount);
event Transfer(address indexed from, address indexed to, uint256 value);
event Withdrawal(address indexed _l2Sender, address indexed _l1Receiver, uint256 _amount);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IBytecodeCompressor {
function publishCompressedBytecode(
bytes calldata _bytecode,
bytes calldata _rawCompressedData
) external payable returns (bytes32 bytecodeHash);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @author Matter Labs
* @dev The interface that is used for encoding/decoding of
* different types of paymaster flows.
* @notice This is NOT an interface to be implementated
* by contracts. It is just used for encoding.
*/
interface IPaymasterFlow {
function general(bytes calldata input) external;
function approvalBased(address _token, uint256 _minAllowance, bytes calldata _innerInput) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
library RLPEncoder {
function encodeAddress(address _val) internal pure returns (bytes memory encoded) {
// The size is equal to 20 bytes of the address itself + 1 for encoding bytes length in RLP.
encoded = new bytes(0x15);
bytes20 shiftedVal = bytes20(_val);
assembly {
// In the first byte we write the encoded length as 0x80 + 0x14 == 0x94.
mstore(add(encoded, 0x20), 0x9400000000000000000000000000000000000000000000000000000000000000)
// Write address data without stripping zeros.
mstore(add(encoded, 0x21), shiftedVal)
}
}
function encodeUint256(uint256 _val) internal pure returns (bytes memory encoded) {
unchecked {
if (_val < 128) {
encoded = new bytes(1);
// Handle zero as a non-value, since stripping zeroes results in an empty byte array
encoded[0] = (_val == 0) ? bytes1(uint8(128)) : bytes1(uint8(_val));
} else {
uint256 hbs = _highestByteSet(_val);
encoded = new bytes(hbs + 2);
encoded[0] = bytes1(uint8(hbs + 0x81));
uint256 lbs = 31 - hbs;
uint256 shiftedVal = _val << (lbs * 8);
assembly {
mstore(add(encoded, 0x21), shiftedVal)
}
}
}
}
/// @notice Encodes the size of bytes in RLP format.
/// @param _len The length of the bytes to encode. It has a `uint64` type since as larger values are not supported.
/// NOTE: panics if the length is 1 since the length encoding is ambiguous in this case.
function encodeNonSingleBytesLen(uint64 _len) internal pure returns (bytes memory) {
assert(_len != 1);
return _encodeLength(_len, 0x80);
}
/// @notice Encodes the size of list items in RLP format.
/// @param _len The length of the bytes to encode. It has a `uint64` type since as larger values are not supported.
function encodeListLen(uint64 _len) internal pure returns (bytes memory) {
return _encodeLength(_len, 0xc0);
}
function _encodeLength(uint64 _len, uint256 _offset) private pure returns (bytes memory encoded) {
unchecked {
if (_len < 56) {
encoded = new bytes(1);
encoded[0] = bytes1(uint8(_len + _offset));
} else {
uint256 hbs = _highestByteSet(uint256(_len));
encoded = new bytes(hbs + 2);
encoded[0] = bytes1(uint8(_offset + hbs + 56));
uint256 lbs = 31 - hbs;
uint256 shiftedVal = uint256(_len) << (lbs * 8);
assembly {
mstore(add(encoded, 0x21), shiftedVal)
}
}
}
}
/// @notice Computes the index of the highest byte set in number.
/// @notice Uses little endian ordering (The least significant byte has index `0`).
/// NOTE: returns `0` for `0`
function _highestByteSet(uint256 _number) private pure returns (uint256 hbs) {
unchecked {
if (_number > type(uint128).max) {
_number >>= 128;
hbs += 16;
}
if (_number > type(uint64).max) {
_number >>= 64;
hbs += 8;
}
if (_number > type(uint32).max) {
_number >>= 32;
hbs += 4;
}
if (_number > type(uint16).max) {
_number >>= 16;
hbs += 2;
}
if (_number > type(uint8).max) {
hbs += 1;
}
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.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.8.0) (token/ERC20/utils/SafeERC20.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
import "../extensions/IERC20Permit.sol";
import "../../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using Address for address;
function safeTransfer(
IERC20 token,
address to,
uint256 value
) internal {
_callOptionalReturn(
token,
abi.encodeWithSelector(token.transfer.selector, to, value)
);
}
function safeTransferFrom(
IERC20 token,
address from,
address to,
uint256 value
) internal {
_callOptionalReturn(
token,
abi.encodeWithSelector(token.transferFrom.selector, from, to, value)
);
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(
IERC20 token,
address spender,
uint256 value
) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(
token,
abi.encodeWithSelector(token.approve.selector, spender, value)
);
}
function safeIncreaseAllowance(
IERC20 token,
address spender,
uint256 value
) internal {
uint256 newAllowance = token.allowance(address(this), spender) + value;
_callOptionalReturn(
token,
abi.encodeWithSelector(
token.approve.selector,
spender,
newAllowance
)
);
}
function safeDecreaseAllowance(
IERC20 token,
address spender,
uint256 value
) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(
oldAllowance >= value,
"SafeERC20: decreased allowance below zero"
);
uint256 newAllowance = oldAllowance - value;
_callOptionalReturn(
token,
abi.encodeWithSelector(
token.approve.selector,
spender,
newAllowance
)
);
}
}
function safePermit(
IERC20Permit token,
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) internal {
uint256 nonceBefore = token.nonces(owner);
token.permit(owner, spender, value, deadline, v, r, s);
uint256 nonceAfter = token.nonces(owner);
require(
nonceAfter == nonceBefore + 1,
"SafeERC20: permit did not succeed"
);
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(
data,
"SafeERC20: low-level call failed"
);
if (returndata.length > 0) {
// Return data is optional
require(
abi.decode(returndata, (bool)),
"SafeERC20: ERC20 operation did not succeed"
);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)
pragma solidity ^0.8.20;
import {Context} from "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* The initial owner is set to the address provided by the deployer. This can
* later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
/**
* @dev The caller account is not authorized to perform an operation.
*/
error OwnableUnauthorizedAccount(address account);
/**
* @dev The owner is not a valid owner account. (eg. `address(0)`)
*/
error OwnableInvalidOwner(address owner);
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the address provided by the deployer as the initial owner.
*/
constructor(address initialOwner) {
if (initialOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(initialOwner);
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
if (owner() != _msgSender()) {
revert OwnableUnauthorizedAccount(_msgSender());
}
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
if (newOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC5267.sol)
pragma solidity ^0.8.20;
interface IERC5267 {
/**
* @dev MAY be emitted to signal that the domain could have changed.
*/
event EIP712DomainChanged();
/**
* @dev returns the fields and values that describe the domain separator used by this contract for EIP-712
* signature.
*/
function eip712Domain()
external
view
returns (
bytes1 fields,
string memory name,
string memory version,
uint256 chainId,
address verifyingContract,
bytes32 salt,
uint256[] memory extensions
);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/MessageHashUtils.sol)
pragma solidity ^0.8.20;
import {Strings} from "../Strings.sol";
/**
* @dev Signature message hash utilities for producing digests to be consumed by {ECDSA} recovery or signing.
*
* The library provides methods for generating a hash of a message that conforms to the
* https://eips.ethereum.org/EIPS/eip-191[ERC-191] and https://eips.ethereum.org/EIPS/eip-712[EIP 712]
* specifications.
*/
library MessageHashUtils {
/**
* @dev Returns the keccak256 digest of an ERC-191 signed data with version
* `0x45` (`personal_sign` messages).
*
* The digest is calculated by prefixing a bytes32 `messageHash` with
* `"\x19Ethereum Signed Message:\n32"` and hashing the result. It corresponds with the
* hash signed when using the https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] JSON-RPC method.
*
* NOTE: The `messageHash` parameter is intended to be the result of hashing a raw message with
* keccak256, although any bytes32 value can be safely used because the final digest will
* be re-hashed.
*
* See {ECDSA-recover}.
*/
function toEthSignedMessageHash(bytes32 messageHash) internal pure returns (bytes32 digest) {
assembly ("memory-safe") {
mstore(0x00, "\x19Ethereum Signed Message:\n32") // 32 is the bytes-length of messageHash
mstore(0x1c, messageHash) // 0x1c (28) is the length of the prefix
digest := keccak256(0x00, 0x3c) // 0x3c is the length of the prefix (0x1c) + messageHash (0x20)
}
}
/**
* @dev Returns the keccak256 digest of an ERC-191 signed data with version
* `0x45` (`personal_sign` messages).
*
* The digest is calculated by prefixing an arbitrary `message` with
* `"\x19Ethereum Signed Message:\n" + len(message)` and hashing the result. It corresponds with the
* hash signed when using the https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] JSON-RPC method.
*
* See {ECDSA-recover}.
*/
function toEthSignedMessageHash(bytes memory message) internal pure returns (bytes32) {
return
keccak256(bytes.concat("\x19Ethereum Signed Message:\n", bytes(Strings.toString(message.length)), message));
}
/**
* @dev Returns the keccak256 digest of an ERC-191 signed data with version
* `0x00` (data with intended validator).
*
* The digest is calculated by prefixing an arbitrary `data` with `"\x19\x00"` and the intended
* `validator` address. Then hashing the result.
*
* See {ECDSA-recover}.
*/
function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
return keccak256(abi.encodePacked(hex"19_00", validator, data));
}
/**
* @dev Returns the keccak256 digest of an EIP-712 typed data (ERC-191 version `0x01`).
*
* The digest is calculated from a `domainSeparator` and a `structHash`, by prefixing them with
* `\x19\x01` and hashing the result. It corresponds to the hash signed by the
* https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] JSON-RPC method as part of EIP-712.
*
* See {ECDSA-recover}.
*/
function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 digest) {
assembly ("memory-safe") {
let ptr := mload(0x40)
mstore(ptr, hex"19_01")
mstore(add(ptr, 0x02), domainSeparator)
mstore(add(ptr, 0x22), structHash)
digest := keccak256(ptr, 0x42)
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../libraries/TransactionHelper.sol";
interface IBootloaderUtilities {
function getTransactionHashes(
Transaction calldata _transaction
) external view returns (bytes32 txHash, bytes32 signedTxHash);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
pragma solidity ^0.8.20;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(
address(this).balance >= amount,
"Address: insufficient balance"
);
(bool success, ) = recipient.call{value: amount}("");
require(
success,
"Address: unable to send value, recipient may have reverted"
);
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data)
internal
returns (bytes memory)
{
return
functionCallWithValue(
target,
data,
0,
"Address: low-level call failed"
);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value
) internal returns (bytes memory) {
return
functionCallWithValue(
target,
data,
value,
"Address: low-level call with value failed"
);
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(
address(this).balance >= value,
"Address: insufficient balance for call"
);
(bool success, bytes memory returndata) = target.call{value: value}(
data
);
return
verifyCallResultFromTarget(
target,
success,
returndata,
errorMessage
);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data)
internal
view
returns (bytes memory)
{
return
functionStaticCall(
target,
data,
"Address: low-level static call failed"
);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return
verifyCallResultFromTarget(
target,
success,
returndata,
errorMessage
);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data)
internal
returns (bytes memory)
{
return
functionDelegateCall(
target,
data,
"Address: low-level delegate call failed"
);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return
verifyCallResultFromTarget(
target,
success,
returndata,
errorMessage
);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage)
private
pure
{
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Strings.sol)
pragma solidity ^0.8.20;
import {Math} from "./math/Math.sol";
import {SignedMath} from "./math/SignedMath.sol";
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant HEX_DIGITS = "0123456789abcdef";
uint8 private constant ADDRESS_LENGTH = 20;
/**
* @dev The `value` string doesn't fit in the specified `length`.
*/
error StringsInsufficientHexLength(uint256 value, uint256 length);
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
assembly ("memory-safe") {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
assembly ("memory-safe") {
mstore8(ptr, byte(mod(value, 10), HEX_DIGITS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toStringSigned(int256 value) internal pure returns (string memory) {
return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value)));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
uint256 localValue = value;
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = HEX_DIGITS[localValue & 0xf];
localValue >>= 4;
}
if (localValue != 0) {
revert StringsInsufficientHexLength(value, length);
}
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal
* representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its checksummed ASCII `string` hexadecimal
* representation, according to EIP-55.
*/
function toChecksumHexString(address addr) internal pure returns (string memory) {
bytes memory buffer = bytes(toHexString(addr));
// hash the hex part of buffer (skip length + 2 bytes, length 40)
uint256 hashValue;
assembly ("memory-safe") {
hashValue := shr(96, keccak256(add(buffer, 0x22), 40))
}
for (uint256 i = 41; i > 1; --i) {
// possible values for buffer[i] are 48 (0) to 57 (9) and 97 (a) to 102 (f)
if (hashValue & 0xf > 7 && uint8(buffer[i]) > 96) {
// case shift by xoring with 0x20
buffer[i] ^= 0x20;
}
hashValue >>= 4;
}
return string(buffer);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b));
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Permit.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
* https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
*
* Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
* presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
* need to send a transaction, and thus is not required to hold Ether at all.
*/
interface IERC20Permit {
/**
* @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
* given ``owner``'s signed approval.
*
* IMPORTANT: The same issues {IERC20-approve} has related to transaction
* ordering also apply here.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `deadline` must be a timestamp in the future.
* - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
* over the EIP712-formatted function arguments.
* - the signature must use ``owner``'s current nonce (see {nonces}).
*
* For more information on the signature format, see the
* https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
* section].
*/
function permit(
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) external;
/**
* @dev Returns the current nonce for `owner`. This value must be
* included whenever a signature is generated for {permit}.
*
* Every successful call to {permit} increases ``owner``'s nonce by one. This
* prevents a signature from being used multiple times.
*/
function nonces(address owner) external view returns (uint256);
/**
* @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
*/
// solhint-disable-next-line func-name-mixedcase
function DOMAIN_SEPARATOR() external view returns (bytes32);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.sol)
pragma solidity ^0.8.20;
import {Panic} from "../Panic.sol";
import {SafeCast} from "./SafeCast.sol";
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Floor, // Toward negative infinity
Ceil, // Toward positive infinity
Trunc, // Toward zero
Expand // Away from zero
}
/**
* @dev Returns the addition of two unsigned integers, with an success flag (no overflow).
*/
function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a + b;
if (c < a) return (false, 0);
return (true, c);
}
}
/**
* @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow).
*/
function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
if (b > a) return (false, 0);
return (true, a - b);
}
}
/**
* @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow).
*/
function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
// Gas optimization: this is cheaper than requiring 'a' not being zero, but the
// benefit is lost if 'b' is also tested.
// See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
if (a == 0) return (true, 0);
uint256 c = a * b;
if (c / a != b) return (false, 0);
return (true, c);
}
}
/**
* @dev Returns the division of two unsigned integers, with a success flag (no division by zero).
*/
function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
if (b == 0) return (false, 0);
return (true, a / b);
}
}
/**
* @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).
*/
function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
if (b == 0) return (false, 0);
return (true, a % b);
}
}
/**
* @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
*
* IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
* However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
* one branch when needed, making this function more expensive.
*/
function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {
unchecked {
// branchless ternary works because:
// b ^ (a ^ b) == a
// b ^ 0 == b
return b ^ ((a ^ b) * SafeCast.toUint(condition));
}
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a > b, a, b);
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a < b, a, b);
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds towards infinity instead
* of rounding towards zero.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
if (b == 0) {
// Guarantee the same behavior as in a regular Solidity division.
Panic.panic(Panic.DIVISION_BY_ZERO);
}
// The following calculation ensures accurate ceiling division without overflow.
// Since a is non-zero, (a - 1) / b will not overflow.
// The largest possible result occurs when (a - 1) / b is type(uint256).max,
// but the largest value we can obtain is type(uint256).max - 1, which happens
// when a = type(uint256).max and b = 1.
unchecked {
return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);
}
}
/**
* @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
* denominator == 0.
*
* 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²⁵⁶ and mod 2²⁵⁶ - 1, then use
// the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2²⁵⁶ + prod0.
uint256 prod0 = x * y; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0.
if (denominator <= prod1) {
Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_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.
uint256 twos = denominator & (0 - denominator);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2²⁵⁶ / 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²⁵⁶. Now that denominator is an odd number, it has an inverse modulo 2²⁵⁶ such
// that denominator * inv ≡ 1 mod 2²⁵⁶. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv ≡ 1 mod 2⁴.
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⁸
inverse *= 2 - denominator * inverse; // inverse mod 2¹⁶
inverse *= 2 - denominator * inverse; // inverse mod 2³²
inverse *= 2 - denominator * inverse; // inverse mod 2⁶⁴
inverse *= 2 - denominator * inverse; // inverse mod 2¹²⁸
inverse *= 2 - denominator * inverse; // inverse mod 2²⁵⁶
// 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²⁵⁶. Since the preconditions guarantee that the outcome is
// less than 2²⁵⁶, 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;
}
}
/**
* @dev 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) {
return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);
}
/**
* @dev Calculate the modular multiplicative inverse of a number in Z/nZ.
*
* If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.
* If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.
*
* If the input value is not inversible, 0 is returned.
*
* NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the
* inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.
*/
function invMod(uint256 a, uint256 n) internal pure returns (uint256) {
unchecked {
if (n == 0) return 0;
// The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)
// Used to compute integers x and y such that: ax + ny = gcd(a, n).
// When the gcd is 1, then the inverse of a modulo n exists and it's x.
// ax + ny = 1
// ax = 1 + (-y)n
// ax ≡ 1 (mod n) # x is the inverse of a modulo n
// If the remainder is 0 the gcd is n right away.
uint256 remainder = a % n;
uint256 gcd = n;
// Therefore the initial coefficients are:
// ax + ny = gcd(a, n) = n
// 0a + 1n = n
int256 x = 0;
int256 y = 1;
while (remainder != 0) {
uint256 quotient = gcd / remainder;
(gcd, remainder) = (
// The old remainder is the next gcd to try.
remainder,
// Compute the next remainder.
// Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd
// where gcd is at most n (capped to type(uint256).max)
gcd - remainder * quotient
);
(x, y) = (
// Increment the coefficient of a.
y,
// Decrement the coefficient of n.
// Can overflow, but the result is casted to uint256 so that the
// next value of y is "wrapped around" to a value between 0 and n - 1.
x - y * int256(quotient)
);
}
if (gcd != 1) return 0; // No inverse exists.
return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.
}
}
/**
* @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.
*
* From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is
* prime, then `a**(p-1) ≡ 1 mod p`. As a consequence, we have `a * a**(p-2) ≡ 1 mod p`, which means that
* `a**(p-2)` is the modular multiplicative inverse of a in Fp.
*
* NOTE: this function does NOT check that `p` is a prime greater than `2`.
*/
function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {
unchecked {
return Math.modExp(a, p - 2, p);
}
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)
*
* Requirements:
* - modulus can't be zero
* - underlying staticcall to precompile must succeed
*
* IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make
* sure the chain you're using it on supports the precompiled contract for modular exponentiation
* at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,
* the underlying function will succeed given the lack of a revert, but the result may be incorrectly
* interpreted as 0.
*/
function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {
(bool success, uint256 result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).
* It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying
* to operate modulo 0 or if the underlying precompile reverted.
*
* IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain
* you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in
* https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack
* of a revert, but the result may be incorrectly interpreted as 0.
*/
function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {
if (m == 0) return (false, 0);
assembly ("memory-safe") {
let ptr := mload(0x40)
// | Offset | Content | Content (Hex) |
// |-----------|------------|--------------------------------------------------------------------|
// | 0x00:0x1f | size of b | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x20:0x3f | size of e | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x40:0x5f | size of m | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x60:0x7f | value of b | 0x<.............................................................b> |
// | 0x80:0x9f | value of e | 0x<.............................................................e> |
// | 0xa0:0xbf | value of m | 0x<.............................................................m> |
mstore(ptr, 0x20)
mstore(add(ptr, 0x20), 0x20)
mstore(add(ptr, 0x40), 0x20)
mstore(add(ptr, 0x60), b)
mstore(add(ptr, 0x80), e)
mstore(add(ptr, 0xa0), m)
// Given the result < m, it's guaranteed to fit in 32 bytes,
// so we can use the memory scratch space located at offset 0.
success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
result := mload(0x00)
}
}
/**
* @dev Variant of {modExp} that supports inputs of arbitrary length.
*/
function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {
(bool success, bytes memory result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Variant of {tryModExp} that supports inputs of arbitrary length.
*/
function tryModExp(
bytes memory b,
bytes memory e,
bytes memory m
) internal view returns (bool success, bytes memory result) {
if (_zeroBytes(m)) return (false, new bytes(0));
uint256 mLen = m.length;
// Encode call args in result and move the free memory pointer
result = abi.encodePacked(b.length, e.length, mLen, b, e, m);
assembly ("memory-safe") {
let dataPtr := add(result, 0x20)
// Write result on top of args to avoid allocating extra memory.
success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)
// Overwrite the length.
// result.length > returndatasize() is guaranteed because returndatasize() == m.length
mstore(result, mLen)
// Set the memory pointer after the returned data.
mstore(0x40, add(dataPtr, mLen))
}
}
/**
* @dev Returns whether the provided byte array is zero.
*/
function _zeroBytes(bytes memory byteArray) private pure returns (bool) {
for (uint256 i = 0; i < byteArray.length; ++i) {
if (byteArray[i] != 0) {
return false;
}
}
return true;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
* towards zero.
*
* This method is based on Newton's method for computing square roots; the algorithm is restricted to only
* using integer operations.
*/
function sqrt(uint256 a) internal pure returns (uint256) {
unchecked {
// Take care of easy edge cases when a == 0 or a == 1
if (a <= 1) {
return a;
}
// In this function, we use Newton's method to get a root of `f(x) := x² - a`. It involves building a
// sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between
// the current value as `ε_n = | x_n - sqrt(a) |`.
//
// For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root
// of the target. (i.e. `2**(e-1) ≤ sqrt(a) < 2**e`). We know that `e ≤ 128` because `(2¹²⁸)² = 2²⁵⁶` is
// bigger than any uint256.
//
// By noticing that
// `2**(e-1) ≤ sqrt(a) < 2**e → (2**(e-1))² ≤ a < (2**e)² → 2**(2*e-2) ≤ a < 2**(2*e)`
// we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar
// to the msb function.
uint256 aa = a;
uint256 xn = 1;
if (aa >= (1 << 128)) {
aa >>= 128;
xn <<= 64;
}
if (aa >= (1 << 64)) {
aa >>= 64;
xn <<= 32;
}
if (aa >= (1 << 32)) {
aa >>= 32;
xn <<= 16;
}
if (aa >= (1 << 16)) {
aa >>= 16;
xn <<= 8;
}
if (aa >= (1 << 8)) {
aa >>= 8;
xn <<= 4;
}
if (aa >= (1 << 4)) {
aa >>= 4;
xn <<= 2;
}
if (aa >= (1 << 2)) {
xn <<= 1;
}
// We now have x_n such that `x_n = 2**(e-1) ≤ sqrt(a) < 2**e = 2 * x_n`. This implies ε_n ≤ 2**(e-1).
//
// We can refine our estimation by noticing that the middle of that interval minimizes the error.
// If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to ε_n ≤ 2**(e-2).
// This is going to be our x_0 (and ε_0)
xn = (3 * xn) >> 1; // ε_0 := | x_0 - sqrt(a) | ≤ 2**(e-2)
// From here, Newton's method give us:
// x_{n+1} = (x_n + a / x_n) / 2
//
// One should note that:
// x_{n+1}² - a = ((x_n + a / x_n) / 2)² - a
// = ((x_n² + a) / (2 * x_n))² - a
// = (x_n⁴ + 2 * a * x_n² + a²) / (4 * x_n²) - a
// = (x_n⁴ + 2 * a * x_n² + a² - 4 * a * x_n²) / (4 * x_n²)
// = (x_n⁴ - 2 * a * x_n² + a²) / (4 * x_n²)
// = (x_n² - a)² / (2 * x_n)²
// = ((x_n² - a) / (2 * x_n))²
// ≥ 0
// Which proves that for all n ≥ 1, sqrt(a) ≤ x_n
//
// This gives us the proof of quadratic convergence of the sequence:
// ε_{n+1} = | x_{n+1} - sqrt(a) |
// = | (x_n + a / x_n) / 2 - sqrt(a) |
// = | (x_n² + a - 2*x_n*sqrt(a)) / (2 * x_n) |
// = | (x_n - sqrt(a))² / (2 * x_n) |
// = | ε_n² / (2 * x_n) |
// = ε_n² / | (2 * x_n) |
//
// For the first iteration, we have a special case where x_0 is known:
// ε_1 = ε_0² / | (2 * x_0) |
// ≤ (2**(e-2))² / (2 * (2**(e-1) + 2**(e-2)))
// ≤ 2**(2*e-4) / (3 * 2**(e-1))
// ≤ 2**(e-3) / 3
// ≤ 2**(e-3-log2(3))
// ≤ 2**(e-4.5)
//
// For the following iterations, we use the fact that, 2**(e-1) ≤ sqrt(a) ≤ x_n:
// ε_{n+1} = ε_n² / | (2 * x_n) |
// ≤ (2**(e-k))² / (2 * 2**(e-1))
// ≤ 2**(2*e-2*k) / 2**e
// ≤ 2**(e-2*k)
xn = (xn + a / xn) >> 1; // ε_1 := | x_1 - sqrt(a) | ≤ 2**(e-4.5) -- special case, see above
xn = (xn + a / xn) >> 1; // ε_2 := | x_2 - sqrt(a) | ≤ 2**(e-9) -- general case with k = 4.5
xn = (xn + a / xn) >> 1; // ε_3 := | x_3 - sqrt(a) | ≤ 2**(e-18) -- general case with k = 9
xn = (xn + a / xn) >> 1; // ε_4 := | x_4 - sqrt(a) | ≤ 2**(e-36) -- general case with k = 18
xn = (xn + a / xn) >> 1; // ε_5 := | x_5 - sqrt(a) | ≤ 2**(e-72) -- general case with k = 36
xn = (xn + a / xn) >> 1; // ε_6 := | x_6 - sqrt(a) | ≤ 2**(e-144) -- general case with k = 72
// Because e ≤ 128 (as discussed during the first estimation phase), we know have reached a precision
// ε_6 ≤ 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either
// sqrt(a) or sqrt(a) + 1.
return xn - SafeCast.toUint(xn > a / xn);
}
}
/**
* @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);
}
}
/**
* @dev Return the log in base 2 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
uint256 exp;
unchecked {
exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);
value >>= exp;
result += exp;
exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);
value >>= exp;
result += exp;
exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);
value >>= exp;
result += exp;
exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);
value >>= exp;
result += exp;
exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);
value >>= exp;
result += exp;
exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);
value >>= exp;
result += exp;
exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);
value >>= exp;
result += exp;
result += SafeCast.toUint(value > 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);
}
}
/**
* @dev Return the log in base 10 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);
}
}
/**
* @dev Return the log in base 256 of a positive value rounded towards zero.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
uint256 isGt;
unchecked {
isGt = SafeCast.toUint(value > (1 << 128) - 1);
value >>= isGt * 128;
result += isGt * 16;
isGt = SafeCast.toUint(value > (1 << 64) - 1);
value >>= isGt * 64;
result += isGt * 8;
isGt = SafeCast.toUint(value > (1 << 32) - 1);
value >>= isGt * 32;
result += isGt * 4;
isGt = SafeCast.toUint(value > (1 << 16) - 1);
value >>= isGt * 16;
result += isGt * 2;
result += SafeCast.toUint(value > (1 << 8) - 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);
}
}
/**
* @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
*/
function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
return uint8(rounding) % 2 == 1;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.20;
import {SafeCast} from "./SafeCast.sol";
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMath {
/**
* @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
*
* IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
* However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
* one branch when needed, making this function more expensive.
*/
function ternary(bool condition, int256 a, int256 b) internal pure returns (int256) {
unchecked {
// branchless ternary works because:
// b ^ (a ^ b) == a
// b ^ 0 == b
return b ^ ((a ^ b) * int256(SafeCast.toUint(condition)));
}
}
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return ternary(a > b, a, b);
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return ternary(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 {
// Formula from the "Bit Twiddling Hacks" by Sean Eron Anderson.
// Since `n` is a signed integer, the generated bytecode will use the SAR opcode to perform the right shift,
// taking advantage of the most significant (or "sign" bit) in two's complement representation.
// This opcode adds new most significant bits set to the value of the previous most significant bit. As a result,
// the mask will either be `bytes32(0)` (if n is positive) or `~bytes32(0)` (if n is negative).
int256 mask = n >> 255;
// A `bytes32(0)` mask leaves the input unchanged, while a `~bytes32(0)` mask complements it.
return uint256((n + mask) ^ mask);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)
pragma solidity ^0.8.20;
/**
* @dev Helper library for emitting standardized panic codes.
*
* ```solidity
* contract Example {
* using Panic for uint256;
*
* // Use any of the declared internal constants
* function foo() { Panic.GENERIC.panic(); }
*
* // Alternatively
* function foo() { Panic.panic(Panic.GENERIC); }
* }
* ```
*
* Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].
*
* _Available since v5.1._
*/
// slither-disable-next-line unused-state
library Panic {
/// @dev generic / unspecified error
uint256 internal constant GENERIC = 0x00;
/// @dev used by the assert() builtin
uint256 internal constant ASSERT = 0x01;
/// @dev arithmetic underflow or overflow
uint256 internal constant UNDER_OVERFLOW = 0x11;
/// @dev division or modulo by zero
uint256 internal constant DIVISION_BY_ZERO = 0x12;
/// @dev enum conversion error
uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;
/// @dev invalid encoding in storage
uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;
/// @dev empty array pop
uint256 internal constant EMPTY_ARRAY_POP = 0x31;
/// @dev array out of bounds access
uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;
/// @dev resource error (too large allocation or too large array)
uint256 internal constant RESOURCE_ERROR = 0x41;
/// @dev calling invalid internal function
uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;
/// @dev Reverts with a panic code. Recommended to use with
/// the internal constants with predefined codes.
function panic(uint256 code) internal pure {
assembly ("memory-safe") {
mstore(0x00, 0x4e487b71)
mstore(0x20, code)
revert(0x1c, 0x24)
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)
// This file was procedurally generated from scripts/generate/templates/SafeCast.js.
pragma solidity ^0.8.20;
/**
* @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow
* checks.
*
* Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
* easily result in undesired exploitation or bugs, since developers usually
* assume that overflows raise errors. `SafeCast` restores this intuition by
* reverting the transaction when such an operation overflows.
*
* Using this library instead of the unchecked operations eliminates an entire
* class of bugs, so it's recommended to use it always.
*/
library SafeCast {
/**
* @dev Value doesn't fit in an uint of `bits` size.
*/
error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);
/**
* @dev An int value doesn't fit in an uint of `bits` size.
*/
error SafeCastOverflowedIntToUint(int256 value);
/**
* @dev Value doesn't fit in an int of `bits` size.
*/
error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);
/**
* @dev An uint value doesn't fit in an int of `bits` size.
*/
error SafeCastOverflowedUintToInt(uint256 value);
/**
* @dev Returns the downcasted uint248 from uint256, reverting on
* overflow (when the input is greater than largest uint248).
*
* Counterpart to Solidity's `uint248` operator.
*
* Requirements:
*
* - input must fit into 248 bits
*/
function toUint248(uint256 value) internal pure returns (uint248) {
if (value > type(uint248).max) {
revert SafeCastOverflowedUintDowncast(248, value);
}
return uint248(value);
}
/**
* @dev Returns the downcasted uint240 from uint256, reverting on
* overflow (when the input is greater than largest uint240).
*
* Counterpart to Solidity's `uint240` operator.
*
* Requirements:
*
* - input must fit into 240 bits
*/
function toUint240(uint256 value) internal pure returns (uint240) {
if (value > type(uint240).max) {
revert SafeCastOverflowedUintDowncast(240, value);
}
return uint240(value);
}
/**
* @dev Returns the downcasted uint232 from uint256, reverting on
* overflow (when the input is greater than largest uint232).
*
* Counterpart to Solidity's `uint232` operator.
*
* Requirements:
*
* - input must fit into 232 bits
*/
function toUint232(uint256 value) internal pure returns (uint232) {
if (value > type(uint232).max) {
revert SafeCastOverflowedUintDowncast(232, value);
}
return uint232(value);
}
/**
* @dev Returns the downcasted uint224 from uint256, reverting on
* overflow (when the input is greater than largest uint224).
*
* Counterpart to Solidity's `uint224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toUint224(uint256 value) internal pure returns (uint224) {
if (value > type(uint224).max) {
revert SafeCastOverflowedUintDowncast(224, value);
}
return uint224(value);
}
/**
* @dev Returns the downcasted uint216 from uint256, reverting on
* overflow (when the input is greater than largest uint216).
*
* Counterpart to Solidity's `uint216` operator.
*
* Requirements:
*
* - input must fit into 216 bits
*/
function toUint216(uint256 value) internal pure returns (uint216) {
if (value > type(uint216).max) {
revert SafeCastOverflowedUintDowncast(216, value);
}
return uint216(value);
}
/**
* @dev Returns the downcasted uint208 from uint256, reverting on
* overflow (when the input is greater than largest uint208).
*
* Counterpart to Solidity's `uint208` operator.
*
* Requirements:
*
* - input must fit into 208 bits
*/
function toUint208(uint256 value) internal pure returns (uint208) {
if (value > type(uint208).max) {
revert SafeCastOverflowedUintDowncast(208, value);
}
return uint208(value);
}
/**
* @dev Returns the downcasted uint200 from uint256, reverting on
* overflow (when the input is greater than largest uint200).
*
* Counterpart to Solidity's `uint200` operator.
*
* Requirements:
*
* - input must fit into 200 bits
*/
function toUint200(uint256 value) internal pure returns (uint200) {
if (value > type(uint200).max) {
revert SafeCastOverflowedUintDowncast(200, value);
}
return uint200(value);
}
/**
* @dev Returns the downcasted uint192 from uint256, reverting on
* overflow (when the input is greater than largest uint192).
*
* Counterpart to Solidity's `uint192` operator.
*
* Requirements:
*
* - input must fit into 192 bits
*/
function toUint192(uint256 value) internal pure returns (uint192) {
if (value > type(uint192).max) {
revert SafeCastOverflowedUintDowncast(192, value);
}
return uint192(value);
}
/**
* @dev Returns the downcasted uint184 from uint256, reverting on
* overflow (when the input is greater than largest uint184).
*
* Counterpart to Solidity's `uint184` operator.
*
* Requirements:
*
* - input must fit into 184 bits
*/
function toUint184(uint256 value) internal pure returns (uint184) {
if (value > type(uint184).max) {
revert SafeCastOverflowedUintDowncast(184, value);
}
return uint184(value);
}
/**
* @dev Returns the downcasted uint176 from uint256, reverting on
* overflow (when the input is greater than largest uint176).
*
* Counterpart to Solidity's `uint176` operator.
*
* Requirements:
*
* - input must fit into 176 bits
*/
function toUint176(uint256 value) internal pure returns (uint176) {
if (value > type(uint176).max) {
revert SafeCastOverflowedUintDowncast(176, value);
}
return uint176(value);
}
/**
* @dev Returns the downcasted uint168 from uint256, reverting on
* overflow (when the input is greater than largest uint168).
*
* Counterpart to Solidity's `uint168` operator.
*
* Requirements:
*
* - input must fit into 168 bits
*/
function toUint168(uint256 value) internal pure returns (uint168) {
if (value > type(uint168).max) {
revert SafeCastOverflowedUintDowncast(168, value);
}
return uint168(value);
}
/**
* @dev Returns the downcasted uint160 from uint256, reverting on
* overflow (when the input is greater than largest uint160).
*
* Counterpart to Solidity's `uint160` operator.
*
* Requirements:
*
* - input must fit into 160 bits
*/
function toUint160(uint256 value) internal pure returns (uint160) {
if (value > type(uint160).max) {
revert SafeCastOverflowedUintDowncast(160, value);
}
return uint160(value);
}
/**
* @dev Returns the downcasted uint152 from uint256, reverting on
* overflow (when the input is greater than largest uint152).
*
* Counterpart to Solidity's `uint152` operator.
*
* Requirements:
*
* - input must fit into 152 bits
*/
function toUint152(uint256 value) internal pure returns (uint152) {
if (value > type(uint152).max) {
revert SafeCastOverflowedUintDowncast(152, value);
}
return uint152(value);
}
/**
* @dev Returns the downcasted uint144 from uint256, reverting on
* overflow (when the input is greater than largest uint144).
*
* Counterpart to Solidity's `uint144` operator.
*
* Requirements:
*
* - input must fit into 144 bits
*/
function toUint144(uint256 value) internal pure returns (uint144) {
if (value > type(uint144).max) {
revert SafeCastOverflowedUintDowncast(144, value);
}
return uint144(value);
}
/**
* @dev Returns the downcasted uint136 from uint256, reverting on
* overflow (when the input is greater than largest uint136).
*
* Counterpart to Solidity's `uint136` operator.
*
* Requirements:
*
* - input must fit into 136 bits
*/
function toUint136(uint256 value) internal pure returns (uint136) {
if (value > type(uint136).max) {
revert SafeCastOverflowedUintDowncast(136, value);
}
return uint136(value);
}
/**
* @dev Returns the downcasted uint128 from uint256, reverting on
* overflow (when the input is greater than largest uint128).
*
* Counterpart to Solidity's `uint128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toUint128(uint256 value) internal pure returns (uint128) {
if (value > type(uint128).max) {
revert SafeCastOverflowedUintDowncast(128, value);
}
return uint128(value);
}
/**
* @dev Returns the downcasted uint120 from uint256, reverting on
* overflow (when the input is greater than largest uint120).
*
* Counterpart to Solidity's `uint120` operator.
*
* Requirements:
*
* - input must fit into 120 bits
*/
function toUint120(uint256 value) internal pure returns (uint120) {
if (value > type(uint120).max) {
revert SafeCastOverflowedUintDowncast(120, value);
}
return uint120(value);
}
/**
* @dev Returns the downcasted uint112 from uint256, reverting on
* overflow (when the input is greater than largest uint112).
*
* Counterpart to Solidity's `uint112` operator.
*
* Requirements:
*
* - input must fit into 112 bits
*/
function toUint112(uint256 value) internal pure returns (uint112) {
if (value > type(uint112).max) {
revert SafeCastOverflowedUintDowncast(112, value);
}
return uint112(value);
}
/**
* @dev Returns the downcasted uint104 from uint256, reverting on
* overflow (when the input is greater than largest uint104).
*
* Counterpart to Solidity's `uint104` operator.
*
* Requirements:
*
* - input must fit into 104 bits
*/
function toUint104(uint256 value) internal pure returns (uint104) {
if (value > type(uint104).max) {
revert SafeCastOverflowedUintDowncast(104, value);
}
return uint104(value);
}
/**
* @dev Returns the downcasted uint96 from uint256, reverting on
* overflow (when the input is greater than largest uint96).
*
* Counterpart to Solidity's `uint96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toUint96(uint256 value) internal pure returns (uint96) {
if (value > type(uint96).max) {
revert SafeCastOverflowedUintDowncast(96, value);
}
return uint96(value);
}
/**
* @dev Returns the downcasted uint88 from uint256, reverting on
* overflow (when the input is greater than largest uint88).
*
* Counterpart to Solidity's `uint88` operator.
*
* Requirements:
*
* - input must fit into 88 bits
*/
function toUint88(uint256 value) internal pure returns (uint88) {
if (value > type(uint88).max) {
revert SafeCastOverflowedUintDowncast(88, value);
}
return uint88(value);
}
/**
* @dev Returns the downcasted uint80 from uint256, reverting on
* overflow (when the input is greater than largest uint80).
*
* Counterpart to Solidity's `uint80` operator.
*
* Requirements:
*
* - input must fit into 80 bits
*/
function toUint80(uint256 value) internal pure returns (uint80) {
if (value > type(uint80).max) {
revert SafeCastOverflowedUintDowncast(80, value);
}
return uint80(value);
}
/**
* @dev Returns the downcasted uint72 from uint256, reverting on
* overflow (when the input is greater than largest uint72).
*
* Counterpart to Solidity's `uint72` operator.
*
* Requirements:
*
* - input must fit into 72 bits
*/
function toUint72(uint256 value) internal pure returns (uint72) {
if (value > type(uint72).max) {
revert SafeCastOverflowedUintDowncast(72, value);
}
return uint72(value);
}
/**
* @dev Returns the downcasted uint64 from uint256, reverting on
* overflow (when the input is greater than largest uint64).
*
* Counterpart to Solidity's `uint64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toUint64(uint256 value) internal pure returns (uint64) {
if (value > type(uint64).max) {
revert SafeCastOverflowedUintDowncast(64, value);
}
return uint64(value);
}
/**
* @dev Returns the downcasted uint56 from uint256, reverting on
* overflow (when the input is greater than largest uint56).
*
* Counterpart to Solidity's `uint56` operator.
*
* Requirements:
*
* - input must fit into 56 bits
*/
function toUint56(uint256 value) internal pure returns (uint56) {
if (value > type(uint56).max) {
revert SafeCastOverflowedUintDowncast(56, value);
}
return uint56(value);
}
/**
* @dev Returns the downcasted uint48 from uint256, reverting on
* overflow (when the input is greater than largest uint48).
*
* Counterpart to Solidity's `uint48` operator.
*
* Requirements:
*
* - input must fit into 48 bits
*/
function toUint48(uint256 value) internal pure returns (uint48) {
if (value > type(uint48).max) {
revert SafeCastOverflowedUintDowncast(48, value);
}
return uint48(value);
}
/**
* @dev Returns the downcasted uint40 from uint256, reverting on
* overflow (when the input is greater than largest uint40).
*
* Counterpart to Solidity's `uint40` operator.
*
* Requirements:
*
* - input must fit into 40 bits
*/
function toUint40(uint256 value) internal pure returns (uint40) {
if (value > type(uint40).max) {
revert SafeCastOverflowedUintDowncast(40, value);
}
return uint40(value);
}
/**
* @dev Returns the downcasted uint32 from uint256, reverting on
* overflow (when the input is greater than largest uint32).
*
* Counterpart to Solidity's `uint32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toUint32(uint256 value) internal pure returns (uint32) {
if (value > type(uint32).max) {
revert SafeCastOverflowedUintDowncast(32, value);
}
return uint32(value);
}
/**
* @dev Returns the downcasted uint24 from uint256, reverting on
* overflow (when the input is greater than largest uint24).
*
* Counterpart to Solidity's `uint24` operator.
*
* Requirements:
*
* - input must fit into 24 bits
*/
function toUint24(uint256 value) internal pure returns (uint24) {
if (value > type(uint24).max) {
revert SafeCastOverflowedUintDowncast(24, value);
}
return uint24(value);
}
/**
* @dev Returns the downcasted uint16 from uint256, reverting on
* overflow (when the input is greater than largest uint16).
*
* Counterpart to Solidity's `uint16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toUint16(uint256 value) internal pure returns (uint16) {
if (value > type(uint16).max) {
revert SafeCastOverflowedUintDowncast(16, value);
}
return uint16(value);
}
/**
* @dev Returns the downcasted uint8 from uint256, reverting on
* overflow (when the input is greater than largest uint8).
*
* Counterpart to Solidity's `uint8` operator.
*
* Requirements:
*
* - input must fit into 8 bits
*/
function toUint8(uint256 value) internal pure returns (uint8) {
if (value > type(uint8).max) {
revert SafeCastOverflowedUintDowncast(8, value);
}
return uint8(value);
}
/**
* @dev Converts a signed int256 into an unsigned uint256.
*
* Requirements:
*
* - input must be greater than or equal to 0.
*/
function toUint256(int256 value) internal pure returns (uint256) {
if (value < 0) {
revert SafeCastOverflowedIntToUint(value);
}
return uint256(value);
}
/**
* @dev Returns the downcasted int248 from int256, reverting on
* overflow (when the input is less than smallest int248 or
* greater than largest int248).
*
* Counterpart to Solidity's `int248` operator.
*
* Requirements:
*
* - input must fit into 248 bits
*/
function toInt248(int256 value) internal pure returns (int248 downcasted) {
downcasted = int248(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(248, value);
}
}
/**
* @dev Returns the downcasted int240 from int256, reverting on
* overflow (when the input is less than smallest int240 or
* greater than largest int240).
*
* Counterpart to Solidity's `int240` operator.
*
* Requirements:
*
* - input must fit into 240 bits
*/
function toInt240(int256 value) internal pure returns (int240 downcasted) {
downcasted = int240(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(240, value);
}
}
/**
* @dev Returns the downcasted int232 from int256, reverting on
* overflow (when the input is less than smallest int232 or
* greater than largest int232).
*
* Counterpart to Solidity's `int232` operator.
*
* Requirements:
*
* - input must fit into 232 bits
*/
function toInt232(int256 value) internal pure returns (int232 downcasted) {
downcasted = int232(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(232, value);
}
}
/**
* @dev Returns the downcasted int224 from int256, reverting on
* overflow (when the input is less than smallest int224 or
* greater than largest int224).
*
* Counterpart to Solidity's `int224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toInt224(int256 value) internal pure returns (int224 downcasted) {
downcasted = int224(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(224, value);
}
}
/**
* @dev Returns the downcasted int216 from int256, reverting on
* overflow (when the input is less than smallest int216 or
* greater than largest int216).
*
* Counterpart to Solidity's `int216` operator.
*
* Requirements:
*
* - input must fit into 216 bits
*/
function toInt216(int256 value) internal pure returns (int216 downcasted) {
downcasted = int216(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(216, value);
}
}
/**
* @dev Returns the downcasted int208 from int256, reverting on
* overflow (when the input is less than smallest int208 or
* greater than largest int208).
*
* Counterpart to Solidity's `int208` operator.
*
* Requirements:
*
* - input must fit into 208 bits
*/
function toInt208(int256 value) internal pure returns (int208 downcasted) {
downcasted = int208(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(208, value);
}
}
/**
* @dev Returns the downcasted int200 from int256, reverting on
* overflow (when the input is less than smallest int200 or
* greater than largest int200).
*
* Counterpart to Solidity's `int200` operator.
*
* Requirements:
*
* - input must fit into 200 bits
*/
function toInt200(int256 value) internal pure returns (int200 downcasted) {
downcasted = int200(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(200, value);
}
}
/**
* @dev Returns the downcasted int192 from int256, reverting on
* overflow (when the input is less than smallest int192 or
* greater than largest int192).
*
* Counterpart to Solidity's `int192` operator.
*
* Requirements:
*
* - input must fit into 192 bits
*/
function toInt192(int256 value) internal pure returns (int192 downcasted) {
downcasted = int192(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(192, value);
}
}
/**
* @dev Returns the downcasted int184 from int256, reverting on
* overflow (when the input is less than smallest int184 or
* greater than largest int184).
*
* Counterpart to Solidity's `int184` operator.
*
* Requirements:
*
* - input must fit into 184 bits
*/
function toInt184(int256 value) internal pure returns (int184 downcasted) {
downcasted = int184(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(184, value);
}
}
/**
* @dev Returns the downcasted int176 from int256, reverting on
* overflow (when the input is less than smallest int176 or
* greater than largest int176).
*
* Counterpart to Solidity's `int176` operator.
*
* Requirements:
*
* - input must fit into 176 bits
*/
function toInt176(int256 value) internal pure returns (int176 downcasted) {
downcasted = int176(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(176, value);
}
}
/**
* @dev Returns the downcasted int168 from int256, reverting on
* overflow (when the input is less than smallest int168 or
* greater than largest int168).
*
* Counterpart to Solidity's `int168` operator.
*
* Requirements:
*
* - input must fit into 168 bits
*/
function toInt168(int256 value) internal pure returns (int168 downcasted) {
downcasted = int168(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(168, value);
}
}
/**
* @dev Returns the downcasted int160 from int256, reverting on
* overflow (when the input is less than smallest int160 or
* greater than largest int160).
*
* Counterpart to Solidity's `int160` operator.
*
* Requirements:
*
* - input must fit into 160 bits
*/
function toInt160(int256 value) internal pure returns (int160 downcasted) {
downcasted = int160(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(160, value);
}
}
/**
* @dev Returns the downcasted int152 from int256, reverting on
* overflow (when the input is less than smallest int152 or
* greater than largest int152).
*
* Counterpart to Solidity's `int152` operator.
*
* Requirements:
*
* - input must fit into 152 bits
*/
function toInt152(int256 value) internal pure returns (int152 downcasted) {
downcasted = int152(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(152, value);
}
}
/**
* @dev Returns the downcasted int144 from int256, reverting on
* overflow (when the input is less than smallest int144 or
* greater than largest int144).
*
* Counterpart to Solidity's `int144` operator.
*
* Requirements:
*
* - input must fit into 144 bits
*/
function toInt144(int256 value) internal pure returns (int144 downcasted) {
downcasted = int144(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(144, value);
}
}
/**
* @dev Returns the downcasted int136 from int256, reverting on
* overflow (when the input is less than smallest int136 or
* greater than largest int136).
*
* Counterpart to Solidity's `int136` operator.
*
* Requirements:
*
* - input must fit into 136 bits
*/
function toInt136(int256 value) internal pure returns (int136 downcasted) {
downcasted = int136(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(136, value);
}
}
/**
* @dev Returns the downcasted int128 from int256, reverting on
* overflow (when the input is less than smallest int128 or
* greater than largest int128).
*
* Counterpart to Solidity's `int128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toInt128(int256 value) internal pure returns (int128 downcasted) {
downcasted = int128(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(128, value);
}
}
/**
* @dev Returns the downcasted int120 from int256, reverting on
* overflow (when the input is less than smallest int120 or
* greater than largest int120).
*
* Counterpart to Solidity's `int120` operator.
*
* Requirements:
*
* - input must fit into 120 bits
*/
function toInt120(int256 value) internal pure returns (int120 downcasted) {
downcasted = int120(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(120, value);
}
}
/**
* @dev Returns the downcasted int112 from int256, reverting on
* overflow (when the input is less than smallest int112 or
* greater than largest int112).
*
* Counterpart to Solidity's `int112` operator.
*
* Requirements:
*
* - input must fit into 112 bits
*/
function toInt112(int256 value) internal pure returns (int112 downcasted) {
downcasted = int112(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(112, value);
}
}
/**
* @dev Returns the downcasted int104 from int256, reverting on
* overflow (when the input is less than smallest int104 or
* greater than largest int104).
*
* Counterpart to Solidity's `int104` operator.
*
* Requirements:
*
* - input must fit into 104 bits
*/
function toInt104(int256 value) internal pure returns (int104 downcasted) {
downcasted = int104(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(104, value);
}
}
/**
* @dev Returns the downcasted int96 from int256, reverting on
* overflow (when the input is less than smallest int96 or
* greater than largest int96).
*
* Counterpart to Solidity's `int96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toInt96(int256 value) internal pure returns (int96 downcasted) {
downcasted = int96(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(96, value);
}
}
/**
* @dev Returns the downcasted int88 from int256, reverting on
* overflow (when the input is less than smallest int88 or
* greater than largest int88).
*
* Counterpart to Solidity's `int88` operator.
*
* Requirements:
*
* - input must fit into 88 bits
*/
function toInt88(int256 value) internal pure returns (int88 downcasted) {
downcasted = int88(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(88, value);
}
}
/**
* @dev Returns the downcasted int80 from int256, reverting on
* overflow (when the input is less than smallest int80 or
* greater than largest int80).
*
* Counterpart to Solidity's `int80` operator.
*
* Requirements:
*
* - input must fit into 80 bits
*/
function toInt80(int256 value) internal pure returns (int80 downcasted) {
downcasted = int80(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(80, value);
}
}
/**
* @dev Returns the downcasted int72 from int256, reverting on
* overflow (when the input is less than smallest int72 or
* greater than largest int72).
*
* Counterpart to Solidity's `int72` operator.
*
* Requirements:
*
* - input must fit into 72 bits
*/
function toInt72(int256 value) internal pure returns (int72 downcasted) {
downcasted = int72(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(72, value);
}
}
/**
* @dev Returns the downcasted int64 from int256, reverting on
* overflow (when the input is less than smallest int64 or
* greater than largest int64).
*
* Counterpart to Solidity's `int64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toInt64(int256 value) internal pure returns (int64 downcasted) {
downcasted = int64(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(64, value);
}
}
/**
* @dev Returns the downcasted int56 from int256, reverting on
* overflow (when the input is less than smallest int56 or
* greater than largest int56).
*
* Counterpart to Solidity's `int56` operator.
*
* Requirements:
*
* - input must fit into 56 bits
*/
function toInt56(int256 value) internal pure returns (int56 downcasted) {
downcasted = int56(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(56, value);
}
}
/**
* @dev Returns the downcasted int48 from int256, reverting on
* overflow (when the input is less than smallest int48 or
* greater than largest int48).
*
* Counterpart to Solidity's `int48` operator.
*
* Requirements:
*
* - input must fit into 48 bits
*/
function toInt48(int256 value) internal pure returns (int48 downcasted) {
downcasted = int48(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(48, value);
}
}
/**
* @dev Returns the downcasted int40 from int256, reverting on
* overflow (when the input is less than smallest int40 or
* greater than largest int40).
*
* Counterpart to Solidity's `int40` operator.
*
* Requirements:
*
* - input must fit into 40 bits
*/
function toInt40(int256 value) internal pure returns (int40 downcasted) {
downcasted = int40(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(40, value);
}
}
/**
* @dev Returns the downcasted int32 from int256, reverting on
* overflow (when the input is less than smallest int32 or
* greater than largest int32).
*
* Counterpart to Solidity's `int32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toInt32(int256 value) internal pure returns (int32 downcasted) {
downcasted = int32(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(32, value);
}
}
/**
* @dev Returns the downcasted int24 from int256, reverting on
* overflow (when the input is less than smallest int24 or
* greater than largest int24).
*
* Counterpart to Solidity's `int24` operator.
*
* Requirements:
*
* - input must fit into 24 bits
*/
function toInt24(int256 value) internal pure returns (int24 downcasted) {
downcasted = int24(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(24, value);
}
}
/**
* @dev Returns the downcasted int16 from int256, reverting on
* overflow (when the input is less than smallest int16 or
* greater than largest int16).
*
* Counterpart to Solidity's `int16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toInt16(int256 value) internal pure returns (int16 downcasted) {
downcasted = int16(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(16, value);
}
}
/**
* @dev Returns the downcasted int8 from int256, reverting on
* overflow (when the input is less than smallest int8 or
* greater than largest int8).
*
* Counterpart to Solidity's `int8` operator.
*
* Requirements:
*
* - input must fit into 8 bits
*/
function toInt8(int256 value) internal pure returns (int8 downcasted) {
downcasted = int8(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(8, value);
}
}
/**
* @dev Converts an unsigned uint256 into a signed int256.
*
* Requirements:
*
* - input must be less than or equal to maxInt256.
*/
function toInt256(uint256 value) internal pure returns (int256) {
// Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
if (value > uint256(type(int256).max)) {
revert SafeCastOverflowedUintToInt(value);
}
return int256(value);
}
/**
* @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.
*/
function toUint(bool b) internal pure returns (uint256 u) {
assembly ("memory-safe") {
u := iszero(iszero(b))
}
}
}{
"evmVersion": "cancun",
"optimizer": {
"enabled": true,
"mode": "3"
},
"outputSelection": {
"*": {
"*": [
"abi"
]
}
},
"detectMissingLibraries": false,
"forceEVMLA": false,
"enableEraVMExtensions": true,
"libraries": {}
}Contract ABI
API[{"inputs":[{"internalType":"address","name":"knownTrustedEoaValidator","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ADDRESS_ALREADY_EXISTS","type":"error"},{"inputs":[],"name":"ADDRESS_NOT_EXISTS","type":"error"},{"inputs":[],"name":"BYTES_ALREADY_EXISTS","type":"error"},{"inputs":[],"name":"BYTES_NOT_EXISTS","type":"error"},{"inputs":[],"name":"CALL_FAILED","type":"error"},{"inputs":[],"name":"EMPTY_HOOK_ADDRESS","type":"error"},{"inputs":[],"name":"EMPTY_MODULE_ADDRESS","type":"error"},{"inputs":[],"name":"EMPTY_OWNERS","type":"error"},{"inputs":[],"name":"EMPTY_VALIDATORS","type":"error"},{"inputs":[],"name":"FEE_PAYMENT_FAILED","type":"error"},{"inputs":[],"name":"HOOK_ERC165_FAIL","type":"error"},{"inputs":[],"name":"INSUFFICIENT_FUNDS","type":"error"},{"inputs":[],"name":"INVALID_ADDRESS","type":"error"},{"inputs":[],"name":"INVALID_BYTES","type":"error"},{"inputs":[],"name":"INVALID_KEY","type":"error"},{"inputs":[],"name":"INVALID_PUBKEY_LENGTH","type":"error"},{"inputs":[],"name":"INVALID_SALT","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"MODULE_ERC165_FAIL","type":"error"},{"inputs":[{"internalType":"uint256","name":"actualValue","type":"uint256"},{"internalType":"uint256","name":"expectedValue","type":"uint256"}],"name":"MsgValueMismatch","type":"error"},{"inputs":[],"name":"NOT_FROM_BOOTLOADER","type":"error"},{"inputs":[],"name":"NOT_FROM_HOOK","type":"error"},{"inputs":[],"name":"NOT_FROM_MODULE","type":"error"},{"inputs":[],"name":"NOT_FROM_SELF","type":"error"},{"inputs":[],"name":"NOT_FROM_SELF_OR_MODULE","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"RECUSIVE_MODULE_CALL","type":"error"},{"inputs":[],"name":"SAME_IMPLEMENTATION","type":"error"},{"inputs":[],"name":"UNAUTHORIZED_OUTSIDE_TRANSACTION","type":"error"},{"inputs":[],"name":"VALIDATION_HOOK_FAILED","type":"error"},{"inputs":[],"name":"VALIDATOR_ERC165_FAIL","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"hook","type":"address"}],"name":"AddHook","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"module","type":"address"}],"name":"AddModule","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"AddModuleValidator","type":"event"},{"anonymous":false,"inputs":[],"name":"EIP712DomainChanged","type":"event"},{"anonymous":false,"inputs":[],"name":"FeePaid","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"addr","type":"address"}],"name":"K1AddOwner","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"K1AddValidator","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"addr","type":"address"}],"name":"K1RemoveOwner","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"K1RemoveValidator","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bytes","name":"pubKey","type":"bytes"}],"name":"R1AddOwner","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"R1AddValidator","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bytes","name":"pubKey","type":"bytes"}],"name":"R1RemoveOwner","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"R1RemoveValidator","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"hook","type":"address"}],"name":"RemoveHook","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"module","type":"address"}],"name":"RemoveModule","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"RemoveModuleValidator","type":"event"},{"anonymous":false,"inputs":[],"name":"ResetOwners","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldImplementation","type":"address"},{"indexed":true,"internalType":"address","name":"newImplementation","type":"address"}],"name":"Upgraded","type":"event"},{"stateMutability":"payable","type":"fallback"},{"inputs":[],"name":"KNOWN_TRUSTED_EOA_VALIDATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VERSION","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"hookAndData","type":"bytes"},{"internalType":"bool","name":"isValidation","type":"bool"}],"name":"addHook","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes","name":"moduleAndData","type":"bytes"}],"name":"addModule","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"bytes","name":"initialAccountValidationKey","type":"bytes"}],"name":"addModuleValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"agwMessageTypeHash","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"pure","type":"function"},{"inputs":[{"components":[{"internalType":"address","name":"target","type":"address"},{"internalType":"bool","name":"allowFailure","type":"bool"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"bytes","name":"callData","type":"bytes"}],"internalType":"struct Call[]","name":"_calls","type":"tuple[]"}],"name":"batchCall","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"eip712Domain","outputs":[{"internalType":"bytes1","name":"fields","type":"bytes1"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"},{"internalType":"uint256","name":"chainId","type":"uint256"},{"internalType":"address","name":"verifyingContract","type":"address"},{"internalType":"bytes32","name":"salt","type":"bytes32"},{"internalType":"uint256[]","name":"extensions","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"executeFromModule","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"},{"internalType":"bytes32","name":"","type":"bytes32"},{"components":[{"internalType":"uint256","name":"txType","type":"uint256"},{"internalType":"uint256","name":"from","type":"uint256"},{"internalType":"uint256","name":"to","type":"uint256"},{"internalType":"uint256","name":"gasLimit","type":"uint256"},{"internalType":"uint256","name":"gasPerPubdataByteLimit","type":"uint256"},{"internalType":"uint256","name":"maxFeePerGas","type":"uint256"},{"internalType":"uint256","name":"maxPriorityFeePerGas","type":"uint256"},{"internalType":"uint256","name":"paymaster","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256[4]","name":"reserved","type":"uint256[4]"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"bytes32[]","name":"factoryDeps","type":"bytes32[]"},{"internalType":"bytes","name":"paymasterInput","type":"bytes"},{"internalType":"bytes","name":"reservedDynamic","type":"bytes"}],"internalType":"struct Transaction","name":"transaction","type":"tuple"}],"name":"executeTransaction","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"txType","type":"uint256"},{"internalType":"uint256","name":"from","type":"uint256"},{"internalType":"uint256","name":"to","type":"uint256"},{"internalType":"uint256","name":"gasLimit","type":"uint256"},{"internalType":"uint256","name":"gasPerPubdataByteLimit","type":"uint256"},{"internalType":"uint256","name":"maxFeePerGas","type":"uint256"},{"internalType":"uint256","name":"maxPriorityFeePerGas","type":"uint256"},{"internalType":"uint256","name":"paymaster","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256[4]","name":"reserved","type":"uint256[4]"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"bytes32[]","name":"factoryDeps","type":"bytes32[]"},{"internalType":"bytes","name":"paymasterInput","type":"bytes"},{"internalType":"bytes","name":"reservedDynamic","type":"bytes"}],"internalType":"struct Transaction","name":"transaction","type":"tuple"}],"name":"executeTransactionFromOutside","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"signedHash","type":"bytes32"}],"internalType":"struct ERC1271Handler.AGWMessage","name":"agwMessage","type":"tuple"}],"name":"getEip712Hash","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"hook","type":"address"},{"internalType":"bytes32","name":"key","type":"bytes32"}],"name":"getHookData","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"implementationAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"initialK1Owner","type":"address"},{"internalType":"address","name":"initialK1Validator","type":"address"},{"internalType":"bytes[]","name":"modules","type":"bytes[]"},{"components":[{"internalType":"address","name":"target","type":"address"},{"internalType":"bool","name":"allowFailure","type":"bool"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"bytes","name":"callData","type":"bytes"}],"internalType":"struct Call","name":"initCall","type":"tuple"}],"name":"initialize","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"isHook","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"isModule","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"isModuleValidator","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"signedHash","type":"bytes32"},{"internalType":"bytes","name":"signatureAndValidator","type":"bytes"}],"name":"isValidSignature","outputs":[{"internalType":"bytes4","name":"magicValue","type":"bytes4"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"k1AddOwner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"k1AddValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"k1IsOwner","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"k1IsValidator","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"k1ListOwners","outputs":[{"internalType":"address[]","name":"k1OwnerList","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"k1ListValidators","outputs":[{"internalType":"address[]","name":"validatorList","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"k1RemoveOwner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"k1RemoveValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"isValidation","type":"bool"}],"name":"listHooks","outputs":[{"internalType":"address[]","name":"hookList","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"listModuleValidators","outputs":[{"internalType":"address[]","name":"validatorList","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"listModules","outputs":[{"internalType":"address[]","name":"moduleList","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155BatchReceived","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC721Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"},{"internalType":"bytes32","name":"","type":"bytes32"},{"components":[{"internalType":"uint256","name":"txType","type":"uint256"},{"internalType":"uint256","name":"from","type":"uint256"},{"internalType":"uint256","name":"to","type":"uint256"},{"internalType":"uint256","name":"gasLimit","type":"uint256"},{"internalType":"uint256","name":"gasPerPubdataByteLimit","type":"uint256"},{"internalType":"uint256","name":"maxFeePerGas","type":"uint256"},{"internalType":"uint256","name":"maxPriorityFeePerGas","type":"uint256"},{"internalType":"uint256","name":"paymaster","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256[4]","name":"reserved","type":"uint256[4]"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"bytes32[]","name":"factoryDeps","type":"bytes32[]"},{"internalType":"bytes","name":"paymasterInput","type":"bytes"},{"internalType":"bytes","name":"reservedDynamic","type":"bytes"}],"internalType":"struct Transaction","name":"transaction","type":"tuple"}],"name":"payForTransaction","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"},{"internalType":"bytes32","name":"","type":"bytes32"},{"components":[{"internalType":"uint256","name":"txType","type":"uint256"},{"internalType":"uint256","name":"from","type":"uint256"},{"internalType":"uint256","name":"to","type":"uint256"},{"internalType":"uint256","name":"gasLimit","type":"uint256"},{"internalType":"uint256","name":"gasPerPubdataByteLimit","type":"uint256"},{"internalType":"uint256","name":"maxFeePerGas","type":"uint256"},{"internalType":"uint256","name":"maxPriorityFeePerGas","type":"uint256"},{"internalType":"uint256","name":"paymaster","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256[4]","name":"reserved","type":"uint256[4]"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"bytes32[]","name":"factoryDeps","type":"bytes32[]"},{"internalType":"bytes","name":"paymasterInput","type":"bytes"},{"internalType":"bytes","name":"reservedDynamic","type":"bytes"}],"internalType":"struct Transaction","name":"transaction","type":"tuple"}],"name":"prepareForPaymaster","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes","name":"pubKey","type":"bytes"}],"name":"r1AddOwner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"r1AddValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes","name":"pubKey","type":"bytes"}],"name":"r1IsOwner","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"r1IsValidator","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"r1ListOwners","outputs":[{"internalType":"bytes[]","name":"r1OwnerList","type":"bytes[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"r1ListValidators","outputs":[{"internalType":"address[]","name":"validatorList","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"pubKey","type":"bytes"}],"name":"r1RemoveOwner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"r1RemoveValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"hook","type":"address"},{"internalType":"bool","name":"isValidation","type":"bool"}],"name":"removeHook","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"module","type":"address"}],"name":"removeModule","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"removeModuleValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes","name":"pubKey","type":"bytes"}],"name":"resetOwners","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"key","type":"bytes32"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"setHookData","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":"newImplementation","type":"address"}],"name":"upgradeTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"},{"internalType":"bytes32","name":"suggestedSignedHash","type":"bytes32"},{"components":[{"internalType":"uint256","name":"txType","type":"uint256"},{"internalType":"uint256","name":"from","type":"uint256"},{"internalType":"uint256","name":"to","type":"uint256"},{"internalType":"uint256","name":"gasLimit","type":"uint256"},{"internalType":"uint256","name":"gasPerPubdataByteLimit","type":"uint256"},{"internalType":"uint256","name":"maxFeePerGas","type":"uint256"},{"internalType":"uint256","name":"maxPriorityFeePerGas","type":"uint256"},{"internalType":"uint256","name":"paymaster","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256[4]","name":"reserved","type":"uint256[4]"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"bytes32[]","name":"factoryDeps","type":"bytes32[]"},{"internalType":"bytes","name":"paymasterInput","type":"bytes"},{"internalType":"bytes","name":"reservedDynamic","type":"bytes"}],"internalType":"struct Transaction","name":"transaction","type":"tuple"}],"name":"validateTransaction","outputs":[{"internalType":"bytes4","name":"magic","type":"bytes4"}],"stateMutability":"payable","type":"function"},{"stateMutability":"payable","type":"receive"}]Contract Creation Code
3cda335100000000000000000000000000000000000000000000000000000000000000000100161b2e96659e6590f51aeb250c7348e91784ed883360cda61e12654ee3050000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000002000000000000000000000000074b9ae28ec45e3fa11533c7954752597c3de3e7a
Deployed Bytecode
0x0014000000000002002300000000000200000000030200190000006002100270000015010020019d0000150102200197001300000021035500020000002103550003000000210355000400000021035500050000002103550006000000210355000700000021035500080000002103550009000000210355000a000000210355000b000000210355000c000000210355000d000000210355000e000000210355000f0000002103550010000000210355001100000021035500120000000103550000000100300190000000650000c13d0000008003000039000000400030043f000000040020008c0000008a0000413d000000000301043b000000e0033002700000150b0030009c0000009a0000a13d0000150c0030009c000000ad0000213d0000151e0030009c000001aa0000a13d0000151f0030009c000003020000a13d000015200030009c000007480000213d000015230030009c0000094a0000613d000015240030009c0000008c0000c13d000000a40020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015040030009c000000880000213d0000002403100370000000000303043b000015040030009c000000880000213d0000004403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d0000000404300039000000000441034f000000000404043b000015070040009c000000880000213d000000050440021000000000034300190000002403300039000000000023004b000000880000213d0000006403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d0000000404300039000000000441034f000000000404043b000015070040009c000000880000213d000000050440021000000000034300190000002403300039000000000023004b000000880000213d0000008401100370000000000101043b000015070010009c000000880000213d000000040110003953ff3a2d0000040f000015890100004100000f030000013d0000000003000416000000000003004b000000880000c13d0000001f032000390000150203300197000000a003300039000000400030043f0000001f0420018f0000150305200198000000a003500039000000760000613d000000a006000039000000000701034f000000007807043c0000000006860436000000000036004b000000720000c13d000000000004004b000000830000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000200020008c000000880000413d000000a00100043d000015040010009c000000dd0000a13d00000000010000190000540100010430000000000002004b0000120a0000613d000000000100041200001504011001970000000002000410000000000021004b0000120a0000c13d0000000001000411000080010010008c0000120a0000c13d000015d701000041000000000010043f0000000101000039000000040010043f000015980100004100005401000104300000152f0030009c000001030000a13d000015300030009c000001220000a13d000015310030009c000002740000a13d000015320030009c0000071f0000213d000015350030009c0000077a0000613d000015360030009c0000008c0000c13d0000000001000416000000000001004b000000880000c13d000015c901000041000000800010043f0000155001000041000054000001042e0000150d0030009c0000024c0000a13d0000150e0030009c000003160000a13d0000150f0030009c0000076f0000213d000015120030009c000009530000613d000015130030009c0000008c0000c13d000000240020008c000000880000413d0000000401100370000000000101043b001500000001001d000015070010009c000000880000213d0000001501000029001b00040010003d0000001b0120006a000015530010009c000000880000213d000002600010008c000000880000413d00000000010004110000150401100197000000020010008c000017020000413d000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000015e70000c13d0000157201000041000000000010043f00001571010000410000540100010430000000800010043f0000150502000041000000000202041a0000150600200198000018750000c13d0000150703200197000015070030009c000000fb0000613d00001507012001c70000150502000041000000000012041b0000150701000041000000400200043d0000000000120435000015010020009c000015010200804100000040012002100000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001508011001c70000800d020000390000000103000039000015090400004153ff53eb0000040f0000000100200190000000880000613d000000800100043d0000000102000039000001400000044300000160001004430000002001000039000001000010044300000120002004430000150a01000041000054000001042e000015410030009c0000018c0000213d000015490030009c0000032a0000213d0000154d0030009c00000a8e0000613d0000154e0030009c00000dc80000613d0000154f0030009c0000008c0000c13d000000840020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015040030009c000000880000213d0000002403100370000000000303043b000015040030009c000000880000213d0000006401100370000000000101043b000015070010009c000000880000213d000000040110003953ff3a2d0000040f000015f10100004100000f030000013d0000153a0030009c0000029a0000213d0000153e0030009c000008640000613d0000153f0030009c000008da0000613d000015400030009c0000008c0000c13d0000000001000416000000000001004b000000880000c13d0000000101000039000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198001b00000000001d00000fe30000c13d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b0000015d0000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b000001590000c13d000000000002004b0000000101000039000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a0000157900100198000001700000c13d000011800000013d000015420030009c000003590000213d000015460030009c00000a9f0000613d000015470030009c00000de30000613d000015480030009c0000008c0000c13d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000601043b000015040060009c000000880000213d00000000010004100000000002000411000000000012004b00000fc70000c13d0000158a01000041000000000201041a0000150405200197000000000065004b000011fe0000c13d000015db01000041000000000010043f00001571010000410000540100010430000015280030009c000003d50000213d0000152c0030009c00000c9e0000613d0000152d0030009c00000ede0000613d0000152e0030009c0000008c0000c13d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010880000c13d000000800200003900000000010004140000000403000039000000000332043600001585040000410000000000430435000015860020009c000014870000213d0000004004200039000000400040043f001a00000004001d000015870040009c000014870000213d0000006004200039000000400040043f0000001a0400002900000000000404350000001b04000029000000040040008c000001ea0000613d000015010030009c000015010300804100000040033002100000000002020433000015010020009c00001501020080410000006002200210000000000232019f000015010010009c0000150101008041000000c001100210000000000112019f0000001b0200002953ff53eb0000040f0000006002100270000115010020019d00130000000103550000001a0100002900000000000104350000001b010000290000157900100198000017020000613d0000001b01000029000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d330000613d0000000101000039001a00000001001d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c000001fc0000c13d0000001b01000029000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015c20400004100001c000000013d000015170030009c0000043e0000213d0000151b0030009c00000d110000613d0000151c0030009c00000ef60000613d0000151d0030009c0000008c0000c13d000000240020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d0000000404300039000000000141034f000000000101043b001b00000001001d000015070010009c000000880000213d0000002403300039001a00000003001d0000001b01300029000000000021004b000000880000213d00000000010004110000000002000410000000000021004b000012f60000c13d0000001a010000290000001b0200002953ff50c90000040f0000000001000019000054000001042e000015370030009c000008520000613d000015380030009c000008b30000613d000015390030009c0000008c0000c13d0000000001000416000000000001004b000000880000c13d0000159501000041000000000101041a000000000001004b00000fb90000c13d0000159601000041000000000101041a000000000001004b00000fb90000c13d0000159001000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000800010043f000000000003004b000012f00000613d0000159002000041000000000020043f000000000001004b0000147a0000c13d0000002005000039000000a0060000390000148f0000013d0000153b0030009c0000086f0000613d0000153c0030009c0000093c0000613d0000153d0030009c0000008c0000c13d0000000001000416000000000001004b000000880000c13d0000000101000039000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198001b00000000001d00000ffb0000c13d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b000002d30000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b000002cf0000c13d000000000002004b0000000101000039000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a0000157900100198000002e60000c13d000011800000013d000015250030009c00000a230000613d000015260030009c00000d500000613d000015270030009c0000008c0000c13d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000015040010009c000000880000213d000000020010008c000017020000413d000000000010043f000015820100004100000eeb0000013d000015140030009c00000a7c0000613d000015150030009c00000d970000613d000015160030009c0000008c0000c13d0000000001000416000000000001004b000000880000c13d0000000001000412001d00000001001d001c00000000003d0000800501000039000000440300003900000000040004150000001d0440008a0000000504400210000015730200004153ff53cd0000040f0000094f0000013d0000154a0030009c00000af60000613d0000154b0030009c00000e030000613d0000154c0030009c0000008c0000c13d000000440020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d001a00040030003d0000001a04100360000000000404043b001b00000004001d000015070040009c000000880000213d0000001b033000290000002403300039000000000023004b000000880000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039001900000002001d000000000012004b000000880000c13d00000000010004110000000002000410000000000021004b000015d30000c13d0000001b010000290018001400100094000016e40000813d000015e701000041000000000010043f00001571010000410000540100010430000015430030009c00000b760000613d000015440030009c00000e7c0000613d000015450030009c0000008c0000c13d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010740000c13d0000001b010000290000157900100198000017020000613d0000001b01000029000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d330000613d0000000101000039001a00000001001d000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c000003820000c13d0000001b01000029000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000000101000039000000000010043f0000155401000041000000200010043f0000159b01000041000000000101041a000015790010019800001bef0000c13d000015d501000041000000000010043f00001571010000410000540100010430000015290030009c00000d370000613d0000152a0030009c00000f0a0000613d0000152b0030009c0000008c0000c13d000000240020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d001b00040030003d0000001b01100360000000000101043b001700000001001d000015070010009c000000880000213d0000002403300039001500000003001d001600170030002d000000160020006b000000880000213d00000000010004110000000002000410000000000021004b0000130a0000c13d0000001701000029000000020010008c00000ddf0000413d000015f6021001980014001f00100193000000400100043d001800000002001d00000000022100190000001b0300002900000020033000390000001203300367000004080000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000004040000c13d000000140000006b000004160000613d000000180330036000000014040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f000000000032043500000017040000290000000002410019000015a8030000410000000000320435000015010010009c000015010100804100000040011002100000002002400039000015010020009c001300000002001d00001501020080410000006002200210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010020019000000001012002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000232013f0000000100200190000008d40000c13d000000000001004b000018790000c13d000015aa01000041000000000010043f00001571010000410000540100010430000015180030009c00000d420000613d000015190030009c00000f4c0000613d0000151a0030009c0000008c0000c13d000000640020008c000000880000413d0000004401100370000000000101043b000500000001001d000015070010009c000000880000213d0000000501000029001b00040010003d0000001b0120006a000015530010009c000000880000213d000002600010008c000000880000413d0000000001000411000080010010008c00000fc30000c13d0000000101000039000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029000702400020003d000802200020003d000902000020003d000a01e00020003d001501c00020003d001401400020003d001301200020003d001201000020003d001100e00020003d001000c00020003d000f00a00020003d000e00800020003d000d00600020003d000c00400020003d000b00200020003d0000000502000029000400440020003d000000200f00008a000004870000013d000000010180021000000001011001bf0000001704000029000000000014041b000000000060043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000200f00008a000000880000613d0000001202000367000000000101043b000000000101041a0000150401100197000000010010008c00001a2c0000a13d001a00000001001d000000400e00043d000015630100004100000000001e04350000000401e00039000000200300003900000000003104350000001b01200360000000000301043b0000002401e0003900000000003104350000000b03200360000000000303043b0000004404e0003900000000003404350000000c03200360000000000303043b0000006404e0003900000000003404350000000d03200360000000000303043b0000008404e0003900000000003404350000000e03200360000000000303043b000000a404e0003900000000003404350000000f03200360000000000303043b000000c404e0003900000000003404350000001003200360000000000303043b000000e404e0003900000000003404350000001103200360000000000303043b0000010404e0003900000000003404350000001203200360000000000303043b0000012404e0003900000000003404350000001303200360000000000303043b0000014404e0003900000000003404350000001403200360000001e406e000390000016404e00039000000003503043c0000000004540436000000000064004b000004bf0000c13d0000001503200360000000000703043b00000000030000310000001b0430006a0000001f0440008a00001556054001970000155608700197000000000958013f000000000058004b00000000080000190000155608004041000000000047004b000000000a000019000015560a008041000015560090009c00000000080ac019000000000008004b000000880000c13d0000001b08700029000000000782034f000000000707043b000015070070009c000000880000213d00000020088000390000000009730049000000000098004b000000000a000019000015560a0020410000155609900197000015560b800197000000000c9b013f00000000009b004b000000000900001900001556090040410000155600c0009c00000000090ac019000000000009004b000000880000c13d000002600900003900000000009604350000028406e000390000000000760435000000000982034f000000000af70170000002a408e000390000000006a80019000004f80000613d000000000b09034f000000000c08001900000000bd0b043c000000000cdc043600000000006c004b000004f40000c13d0000001f0b700190000005050000613d0000000009a9034f000000030ab00210000000000b060433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000960435000000000687001900000000000604350000000a06200360000000000606043b0000155609600197000000000a59013f000000000059004b00000000090000190000155609004041000000000046004b000000000b000019000015560b0080410000155600a0009c00000000090bc019000000000009004b000000880000c13d0000001b09600029000000000692034f000000000606043b000015070060009c000000880000213d0000002009900039000000000a6300490000000000a9004b000000000b000019000015560b002041000015560aa00197000015560c900197000000000dac013f0000000000ac004b000000000a000019000015560a0040410000155600d0009c000000000a0bc01900000000000a004b000000880000c13d0000001f077000390000000007f7016f00000000078700190000000008170049000002040ae0003900000000008a0435000000000992034f0000000007670436000000000af601700000000008a700190000053a0000613d000000000b09034f000000000c07001900000000bd0b043c000000000cdc043600000000008c004b000005360000c13d0000001f0b600190000005470000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000876001900000000000804350000000908200360000000000808043b0000155609800197000000000a59013f000000000059004b00000000090000190000155609004041000000000048004b000000000b000019000015560b0080410000155600a0009c00000000090bc019000000000009004b000000880000c13d0000001b08800029000000000982034f000000000a09043b0000150700a0009c000000880000213d00000020098000390000000508a00210000000000b8300490000000000b9004b000000000c000019000015560c002041000015560bb00197000015560d90019700190000000e001d000000000ebd013f0000000000bd004b000000000b000019000015560b0040410000155600e0009c000000190e000029000000000b0cc01900000000000b004b000000880000c13d0000001f066000390000000006f6016f00000000067600190000000007160049000002240be0003900000000007b04350000000006a604360000000007860019000000000008004b0000057d0000613d000000000992034f000000009a09043c0000000006a60436000000000076004b000005790000c13d0000001f008001900000000806200360000000000606043b0000155608600197000000000958013f000000000058004b00000000080000190000155608004041000000000046004b000000000a000019000015560a008041000015560090009c00000000080ac019000000000008004b000000880000c13d0000001b08600029000000000682034f000000000606043b000015070060009c000000880000213d00000020088000390000000009630049000000000098004b000000000a000019000015560a0020410000155609900197000015560b800197000000000c9b013f00000000009b004b000000000900001900001556090040410000155600c0009c00000000090ac019000000000009004b000000880000c13d0000000009170049000002440ae0003900000000009a0435000000000982034f0000000007670436000000000af601700000000008a70019000005ae0000613d000000000b09034f000000000c07001900000000bd0b043c000000000cdc043600000000008c004b000005aa0000c13d0000001f0b600190000005bb0000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000876001900000000000804350000000708200360000000000808043b0000155609800197000000000a59013f000000000059004b00000000050000190000155605004041000000000048004b000000000400001900001556040080410000155600a0009c000000000504c019000000000005004b000000880000c13d0000001b05800029000000000452034f000000000404043b000015070040009c000000880000213d00000020055000390000000003430049000000000035004b0000000008000019000015560800204100001556033001970000155609500197000000000a39013f000000000039004b000000000300001900001556030040410000155600a0009c000000000308c019000000000003004b000000880000c13d0000001f036000390000000003f3016f000000000673001900000000011600490000026403e000390000000000130435000000000352034f00000000014604360000000005f401700000000002510019000005f00000613d000000000603034f0000000007010019000000006806043c0000000007870436000000000027004b000005ec0000c13d0000001f06400190000005fd0000613d000000000353034f0000000305600210000000000602043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f00000000003204350000000002140019000000000002043500000000050004140000001a02000029000000040020008c000006090000c13d000000130100036700000001030000310000000004f3017000000000024e0019000006250000c13d0000062b0000013d0000001f034000390000000003f3016f0000000001e100490000000001310019000015010010009c000015010100804100000060011002100000150100e0009c000015010300004100000000030e40190000004003300210000000000131019f000015010050009c0000150105008041000000c003500210000000000113019f53ff53eb0000040f0000006003100270000115010030019d00001501033001970013000000010355000000010020019000001bd10000613d000000200f00008a000000190e0000290000000004f3017000000000024e00190000062b0000613d000000000501034f00000000060e0019000000005705043c0000000006760436000000000026004b000006270000c13d0000001f05300190000006380000613d000000000141034f0000000304500210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f013000390000000001f1016f0000000007e10019000000000017004b00000000010000390000000101004039000015070070009c000014870000213d0000000100100190000014870000c13d000000400070043f000015530030009c000000880000213d000000200030008c000000880000413d00000000010e0433000015070010009c000000880000213d0000000003e300190000000001e100190000001f02100039000000000032004b0000000004000019000015560400804100001556022001970000155605300197000000000652013f000000000052004b00000000020000190000155602004041000015560060009c000000000204c019000000000002004b000000880000c13d0000000021010434000015070010009c000014870000213d0000001f041000390000000004f4016f0000003f044000390000000004f4016f0000000004740019000015070040009c000014870000213d000000400040043f0000000004170436001800000004001d0000000004210019000000000034004b000000880000213d001900000007001d0000000004f1016f0000001f0310018f0000001809000029000000000092004b000006810000813d000000000004004b0000067c0000613d00000000063200190000000005390019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000006760000c13d000000000003004b0000001a06000029000006980000613d00000000050900190000068e0000013d0000000005490019000000000004004b0000068a0000613d0000000006020019000000000709001900000000680604340000000007870436000000000057004b000006860000c13d000000000003004b0000001a06000029000006980000613d00000000024200190000000303300210000000000405043300000000043401cf000000000434022f00000000020204330000010003300089000000000232022f00000000023201cf000000000242019f000000000025043500000000019100190000000000010435000000000060043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f00000019030000290000000100200190000000880000613d000000000401043b0000000005030433000015070050009c000014870000213d000000000104041a000000010010019000000001031002700000007f0330618f0000001f0030008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d000000200030008c001700000004001d001600000005001d000006e30000413d000600000003001d000000000040043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000016050000290000001f025000390000000502200270000000200050008c0000000002004019000000000301043b00000006010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b0000001704000029000006e30000813d000000000002041b0000000102200039000000000012004b000006df0000413d000000200050008c000007040000413d000000000040043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f00000019070000290000000100200190000000880000613d0000001608000029000015f602800198000000000101043b000007120000613d000000010320008a00000005033002700000000003310019000000010430003900000020030000390000001a0600002900000000057300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b000006fa0000c13d000000000082004b000004760000813d000007160000013d000000000005004b0000001a06000029000007100000613d0000000301500210000015f70110027f000015f70110016700000018020000290000000002020433000000000112016f0000000102500210000000000121019f000004790000013d0000000001000019000004790000013d00000020030000390000001a06000029000000000082004b000004760000813d0000000302800210000000f80220018f000015f70220027f000015f70220016700000000037300190000000003030433000000000223016f000000000021041b000004760000013d000015330030009c000007dc0000613d000015340030009c0000008c0000c13d000000240020008c000000880000413d0000000403100370000000000903043b000015070090009c000000880000213d0000002303900039000000000023004b000000880000813d0000000403900039000000000331034f000000000303043b001700000003001d000015070030009c000000880000213d0000002408900039000000170300002900000005033002100000000003830019000000000023004b000000880000213d00000000030004100000000004000411000000000034004b00000fc70000c13d000000170000006b000000000b000019000014b10000c13d000000000100041600000000001b004b0000120a0000613d000015c502000041000000000020043f000000040010043f0000002400b0043f000015b3010000410000540100010430000015210030009c000009a40000613d000015220030009c0000008c0000c13d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010b80000c13d0000000001000415001a00000001001d000000400100043d00000020051000390000157e03000041000000000035043500000024041000390000000000340435000000240200003900000000002104350000155a0010009c000014870000213d0000006003100039000000400030043f0000001b02000029000000040020008c000012af0000c13d0000000001050433000000000010043f0000000103000031000012d90000013d000015100030009c00000a0e0000613d000015110030009c0000008c0000c13d0000000001000416000000000001004b000000880000c13d0000000101000039000000800010043f0000155001000041000054000001042e0000000001000416000000000001004b000000880000c13d0000000101000039000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198001b00000000001d00000fcb0000c13d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b000007ad0000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b000007a90000c13d000000000002004b0000000101000039000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a0000157900100198000007c00000c13d000011800000013d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010130000c13d0000001b010000290000157900100198000017020000613d0000001b01000029000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d330000613d0000000101000039001a00000001001d000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c000007ff0000c13d0000001b01000029000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000000101000039000000000010043f0000157a01000041000000200010043f000015c601000041000000000101041a000015790010019800001bf80000c13d000015c801000041000000000010043f00001571010000410000540100010430000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010270000c13d0000001b0100002953ff4f390000040f0000000001000019000054000001042e000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000015040010009c000000880000213d53ff52b40000040f00000f000000013d000000440020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b001b00000003001d0000002403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d001900040030003d0000001901100360000000000101043b001a00000001001d000015070010009c000000880000213d0000002403300039001800000003001d0000001a01300029000000000021004b000000880000213d00000000010004110000150401100197000000020010008c000017020000413d001700000001001d000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000016dd0000c13d0000001701000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000016dd0000c13d000015d301000041000000000010043f000015710100004100005401000104300000000001000416000000000001004b000000880000c13d000000c001000039000000400010043f0000000101000039000000800010043f000000a00000043f000000c00100043d000015cf01100197000000c00010043f000015a801000041000000c10010043f0000000001000414000015010010009c0000150101008041000000c001100210000015d0011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001052002700000007f0550618f0000001f0050008c00000000040000390000000104002039000000000442013f00000001004001900000103b0000613d000015d701000041000000000010043f0000002201000039000000040010043f000015980100004100005401000104300000000001000416000000000001004b000000880000c13d0000000101000039000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198001b00000000001d0000105c0000c13d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b0000090d0000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b000009090000c13d000000000002004b0000000101000039000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a0000157900100198000009200000c13d000011800000013d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d000000a002000039000000400020043f0000000401100370000000000101043b000000800010043f000000800100003953ff3ade0000040f53ff3b070000040f00000f030000013d0000000001000416000000000001004b000000880000c13d0000158a01000041000000000101041a0000150401100197000000800010043f0000155001000041000054000001042e000000440020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000402100370000000000202043b000015040020009c000000880000213d0000002401100370000000000101043b001b00000001001d000000000020043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000001b02000029000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001062002700000007f0660618f0000001f0060008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400500043d0000000004650436000000000003004b001b00000005001d000015c50000613d001900000004001d001a00000006001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001a06000029000000000006004b00000000020000190000001b050000290000001907000029000015ca0000613d000000000101043b00000000020000190000000003270019000000000401041a000000000043043500000001011000390000002002200039000000000062004b0000099c0000413d000015ca0000013d000000440020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000402100370000000000202043b001b00000002001d000015040020009c000000880000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039001a00000002001d000000000012004b000000880000c13d00000000010004110000000002000410000000000021004b0000120c0000c13d0000001b0100002900001579011001970000001a0000006b000012200000c13d000000000001004b000017020000613d0000001b01000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d330000613d0000000101000039001a00000001001d000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c000009d20000c13d0000001b01000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000156201000041000000200010043f00000000010004140000126f0000013d000000a40020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015040030009c000000880000213d0000002403100370000000000303043b000015040030009c000000880000213d0000008401100370000000000101043b000015070010009c000000880000213d000000040110003953ff3a2d0000040f000015510100004100000f030000013d000000640020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b001b00000003001d000015040030009c000000880000213d0000002403100370000000000303043b001a00000003001d0000004403100370000000000403043b000015070040009c000000880000213d0000002303400039000000000023004b000000880000813d0000000405400039000000000351034f000000000303043b000015070030009c000014870000213d0000001f07300039000015f6077001970000003f07700039000015f607700197000015a30070009c000014870000213d00000024044000390000008007700039000000400070043f000000800030043f0000000004430019000000000024004b000000880000213d0000002002500039000000000221034f000015f6043001980000001f0530018f000000a00140003900000a550000613d000000a006000039000000000702034f000000007807043c0000000006860436000000000016004b00000a510000c13d000000000005004b00000a620000613d000000000242034f0000000304500210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f0000000000210435000000a001300039000000000001043500000000010004110000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800001a170000c13d000015a701000041000000000010043f00001571010000410000540100010430000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b0000109d0000c13d0000001b0100002953ff50770000040f0000000001000019000054000001042e000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000201043b000015f300200198000000880000c13d0000000101000039000015f40020009c000010b10000213d000000000002004b00000ef30000613d0000157e0020009c00000ef30000613d000010b50000013d000000440020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b001b00000003001d000015040030009c000000880000213d0000002403100370000000000403043b000015070040009c000000880000213d0000002303400039000000000023004b000000880000813d0000000405400039000000000351034f000000000303043b000015070030009c000014870000213d0000001f06300039000015f6066001970000003f06600039000015f606600197000015a30060009c000014870000213d00000024044000390000008006600039000000400060043f000000800030043f0000000004430019000000000024004b000000880000213d0000002002500039000000000221034f000015f6043001980000001f0530018f000000a00140003900000ace0000613d000000a006000039000000000702034f000000007807043c0000000006860436000000000016004b00000aca0000c13d000000000005004b00000adb0000613d000000000242034f0000000304500210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f0000000000210435000000a001300039000000000001043500000000010004110000000002000410000000000021004b000016ff0000c13d0000000001000415001a00000001001d000000400100043d00000020021000390000157e03000041000000000032043500000024041000390000000000340435000000240300003900000000003104350000155a0010009c000014870000213d0000006003100039000000400030043f0000001b03000029000000040030008c000019750000c13d0000000001020433000000000010043f0000000103000031000019a00000013d000000440020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b0000002404100370000000000504043b000015070050009c000000880000213d0000002304500039000000000024004b000000880000813d0000000406500039000000000461034f000000000404043b0000158d0040009c000014870000813d0000001f07400039000015f6077001970000003f07700039000015f607700197000015a30070009c000014870000213d00000024055000390000008007700039000000400070043f000000800040043f0000000005540019000000000025004b000000880000213d0000002002600039000000000221034f000015f6054001980000001f0640018f000000a00150003900000b220000613d000000a007000039000000000802034f000000008908043c0000000007970436000000000017004b00000b1e0000c13d000000000006004b00000b2f0000613d000000000252034f0000000305600210000000000601043300000000065601cf000000000656022f000000000202043b0000010005500089000000000252022f00000000025201cf000000000262019f0000000000210435000000a0014000390000000000010435000000800100043d000015530010009c000000880000213d000000400010008c000000880000413d000000a00200043d000015070020009c000000880000213d000000bf05200039000000a00410003900001556014001970000155606500197000000000716013f000000000016004b00000000010000190000155601004041000000000045004b00000000050000190000155605008041000015560070009c000000000105c019000000000001004b000000880000c13d000000a0012000390000000001010433000015070010009c000014870000213d0000001f05100039000015f6055001970000003f05500039000015f605500197000000400600043d0000000005560019001600000006001d000000000065004b00000000060000390000000106004039000015070050009c000014870000213d0000000100600190000014870000c13d000000400050043f00000016050000290000000005150436001800000005001d000000c0022000390000000005210019000000000045004b000000880000213d000015f6051001970000001f0410018f000000180020006c00001d550000813d000000000005004b00000b720000613d00000000074200190000001806400029000000200660008a000000200770008a0000000008560019000000000957001900000000090904330000000000980435000000200550008c00000b6c0000c13d000000000004004b00001d6b0000613d000000180600002900001d610000013d000000240020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d0000000404300039000000000141034f000000000101043b001600000001001d000015070010009c000000880000213d0000002403300039001500000003001d0000001601300029000000000021004b000000880000213d00000000010004110000000002000410000000000021004b0000131e0000c13d00000080020000390000004001200039000000400010043f0000002001200039000000000001043500000001010000390000000000120435000000000502001900000b9f0000013d000000000003041b0000000001050433000000010010008c0000000002050019000017c30000a13d001a00000002001d000015f6041001970000001f0310018f0000002009500039000000400200043d000000000029004b00000bb70000813d000000000004004b00000bb20000613d00000000063900190000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c00000bac0000c13d000000000003004b00000bcd0000613d0000000004090019000000000502001900000bc30000013d0000000005420019000000000004004b00000bc00000613d0000000006090019000000000702001900000000680604340000000007870436000000000057004b00000bbc0000c13d000000000003004b00000bcd0000613d00000000044900190000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f0000000000350435001900000009001d0000000003120019000015a8040000410000000000430435000015010020009c000015010200804100000040022002100000002001100039000015010010009c00001501010080410000006001100210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001062002700000007f0660618f0000001f0060008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400500043d0000000004650436000000000003004b001b00000005001d00000c100000613d001700000004001d001800000006001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001807000029000000000007004b0000001a0600002900000c180000613d000000000201043b00000000010000190000001b05000029000000190900002900000017080000290000000003180019000000000402041a000000000043043500000001022000390000002001100039000000000071004b00000c080000413d00000c1b0000013d000015f8012001970000000000140435000000000006004b0000002001000039000000000100603900000019090000290000001a0600002900000c1b0000013d00000000010000190000001b0500002900000019090000290000003f01100039000015f6021001970000000001520019000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f0000000002060433000015f6042001970000001f0320018f000000000019004b00000c3b0000813d000000000004004b00000c370000613d00000000063900190000000005310019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c00000c310000c13d000000000003004b00000c510000613d000000000501001900000c470000013d0000000005410019000000000004004b00000c440000613d0000000006090019000000000701001900000000680604340000000007870436000000000057004b00000c400000c13d000000000003004b00000c510000613d00000000094900190000000303300210000000000405043300000000043401cf000000000434022f00000000060904330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000003120019000015a8040000410000000000430435000015010010009c000015010100804100000040011002100000002002200039000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000301043b000000000103041a000000010010019000000001041002700000007f0440618f0000001f0040008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d000000000004004b0000001b0500002900000b9b0000613d0000001f0040008c00000b9a0000a13d001900000004001d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c70000801002000039001a00000003001d53ff53f00000040f0000000100200190000000880000613d0000001a03000029000000000201043b00000019010000290000001f01100039000000050110027000000000011200190000000102200039000000000012004b00000c8f0000813d000000000002041b0000000102200039000000000012004b00000c8b0000413d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000301043b0000001a02000029000000000002041b0000001b0500002900000b9a0000013d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010e40000c13d0000001b010000290000157900100198000017020000613d0000001b01000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d330000613d0000000101000039001a00000001001d000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c00000cc10000c13d0000001b01000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015c30400004100001c000000013d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b001b00000001001d000015040010009c000000880000213d00000000010004110000000002000410000000000021004b000010f80000c13d0000001b010000290000157900100198000017020000613d0000001b01000029000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000014290000c13d000015d601000041000000000010043f00001571010000410000540100010430000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000015040010009c000000880000213d53ff52cf0000040f00000f000000013d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000015040010009c000000880000213d000000020010008c000017020000413d000000000010043f0000157a0100004100000eeb0000013d000000840020008c000000880000413d0000000403100370000000000303043b001b00000003001d000015040030009c000000880000213d0000002403100370000000000303043b001900000003001d000015040030009c000000880000213d0000004403100370000000000303043b001a00000003001d000015070030009c000000880000213d0000001a030000290000002303300039000000000023004b000000880000813d0000001a030000290000000403300039000000000331034f000000000303043b001800000003001d000015070030009c000000880000213d0000001a03000029001700240030003d000000180300002900000005033002100000001703300029000000000023004b000000880000213d0000006401100370000000000101043b001600000001001d000015070010009c000000880000213d000000160120006a000015530010009c000000880000213d000000840010008c000000880000413d0000150501000041000000000101041a001515060010019b0000150702100198000018650000613d000000010020008c000018750000c13d00001569010000410000000000100443000000000100041000000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000000001004b000018750000c13d0000150501000041000000000101041a000018670000013d000000640020008c000000880000413d0000004403100370000000000303043b000015070030009c000000880000213d0000000002320049000000040220008a000015530020009c000000880000213d000002600020008c000000880000413d0000000002000411000080010020008c00000fc30000c13d000000a402300039000000000221034f0000006403300039000000000131034f000000000101043b000000000202043b000000000002004b000013350000c13d00000000010004150000001f0110008a001b0005001002180000000001000414000015010010009c0000150101008041000000c001100210000080010200003953ff53eb0000040f00130000000103550000006001100270000115010010019d0000001b01000029000000050110027000000001012001950000000100200190000014250000613d0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d0200003900000001030000390000157604000041000012070000013d000000240020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000403043b000015070040009c000000880000213d0000002303400039000000000023004b000000880000813d0000000405400039000000000351034f000000000303043b000015070030009c000000880000213d00000000043400190000002404400039000000000024004b000000880000213d000000010030008c000013630000213d000015f201000041000000000010043f00001571010000410000540100010430000000240020008c000000880000413d0000000003000416000000000003004b000000880000c13d0000000403100370000000000303043b000015070030009c000000880000213d0000002304300039000000000024004b000000880000813d0000000404300039000000000141034f000000000101043b001b00000001001d000015070010009c000000880000213d0000002403300039001a00000003001d0000001b01300029000000000021004b000000880000213d00000000010004110000000002000410000000000021004b000013850000c13d0000001a010000290000001b0200002953ff4c890000040f0000000001000019000054000001042e000000640020008c000000880000413d0000004403100370000000000303043b001b00000003001d000015070030009c000000880000213d0000001b03000029001a00040030003d0000001a0220006a000015530020009c000000880000213d000002600020008c000000880000413d0000002402100370000000000302043b0000000002000411000080010020008c00000fc30000c13d001800000003001d0000001b02000029001901040020003d0000001901100360000000000101043b00000000020004140000155903000041000000a00030043f000000a40010043f0000002401000039000000800010043f000000e001000039000000400010043f000000c0012002100000155c01100197000015e9011001c70000800302000039000000000300001900000000040000190000000005000019000000000600001953ff53eb0000040f00130000000103550000006003100270000115010030019d00001501063001970000001f0360003900001502073001970000003f037000390000156105300197000000400400043d0000000003450019000000000053004b00000000050000390000000105004039000015070030009c000014870000213d0000000100500190000014870000c13d000000400030043f00000000056404360000001203000367000000000007004b00000e490000613d000000000775001900000000083003680000000009050019000000008a08043c0000000009a90436000000000079004b00000e450000c13d0000001f0760018f0000150308600198000000000685001900000e530000613d000000000901034f000000000a050019000000009b09043c000000000aba043600000000006a004b00000e4f0000c13d000000000007004b00000e600000613d000000000181034f0000000307700210000000000806043300000000087801cf000000000878022f000000000101043b0000010007700089000000000171022f00000000017101cf000000000181019f000000000016043500000001002001900000168f0000613d000000190100002900190020001000920000001901300360000000000101043b0000150400100198000017060000c13d0000001902000029000000400120008a000000000113034f000000800220008a000000000423034f000000000404043b000000000501043b00000000015400a9000000000005004b00000e750000613d00000000055100d9000000000045004b000038d60000c13d000000c002200039000000000223034f000000000202043b000000000012001a000038d60000413d00000000011200190000170a0000013d0000000001000416000000000001004b000000880000c13d0000000101000039000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198001b00000000001d000010cc0000c13d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b00000eaf0000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b00000eab0000c13d000000000002004b0000000101000039000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a000015790010019800000ec20000c13d000011800000013d000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000015040010009c000000880000213d000000020010008c000017020000413d000000000010043f0000157b01000041000000200010043f0000004002000039000000000100001953ff53b80000040f000000000101041a00001504001001980000000001000039000000010100c039000000800010043f0000155001000041000054000001042e000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000015040010009c000000880000213d53ff4f070000040f000000000001004b0000000001000039000000010100c039000000400200043d0000000000120435000015010020009c0000150102008041000000400120021000001552011001c7000054000001042e000000640020008c000000880000413d0000004403100370000000000303043b000015070030009c000000880000213d00000004043000390000000005420049000015530050009c000000880000213d000002600050008c000000880000413d0000000006000411000080010060008c00000fc30000c13d0000022403300039000000000631034f000000000606043b0000001f0550008a00001556076001970000155608500197000000000987013f000000000087004b00000000070000190000155607004041000000000056004b00000000050000190000155605008041000015560090009c000000000705c019000000000007004b000000880000c13d0000000005460019000000000451034f000000000404043b000015070040009c000000880000213d0000000006420049000000200550003900001556076001970000155608500197000000000978013f000000000078004b00000000070000190000155607004041000000000065004b00000000060000190000155606002041000015560090009c000000000706c019000000000007004b000000880000c13d000000030040008c000018180000213d0000156c01000041000000800010043f0000002001000039000000840010043f0000003a01000039000000a40010043f000015c001000041000000c40010043f000015c101000041000000e40010043f000015bd010000410000540100010430000000240020008c000000880000413d0000000002000416000000000002004b000000880000c13d0000000401100370000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d0000000102000039000000000020043f000000000001004b0000110c0000c13d0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198001b00000000001d0000134b0000c13d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b00000f8a0000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b00000f860000c13d000000000002004b0000000101000039000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a000015790010019800000f9d0000c13d000011800000013d0000156c01000041000000800010043f0000002001000039000000840010043f0000001501000039000000a40010043f000015ca01000041000000c40010043f000015bf010000410000540100010430000015e801000041000000000010043f00001571010000410000540100010430000015d901000041000000000010043f00001571010000410000540100010430001b00000000001d0000150401100197000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a000015790010019800000fcc0000c13d0000001b01000029000015070010009c0000078f0000a13d000014870000013d001b00000000001d0000150401100197000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a000015790010019800000fe40000c13d0000001b01000029000015070010009c0000013f0000a13d000014870000013d001b00000000001d0000150401100197000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a000015790010019800000ffc0000c13d0000001b01000029000015070010009c000002b50000a13d000014870000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000007ea0000c13d000018140000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000008600000c13d000018140000013d000000400700043d0000000004570436000000000003004b0000118e0000613d001900000004001d001b00000005001d001a00000007001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b05000029000000000005004b00000000020000190000001a070000290000001906000029000011930000613d000000000101043b00000000020000190000000003260019000000000401041a000000000043043500000001011000390000002002200039000000000052004b000010540000413d000011930000013d001b00000000001d0000150401100197000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a00001579001001980000105d0000c13d0000001b01000029000015070010009c000008ef0000a13d000014870000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000036d0000c13d000018140000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000018140000613d000000400200043d000001c10000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000a8a0000c13d000018140000013d000015f50020009c00000ef30000613d000015f10020009c00000ef30000613d000000800000043f0000155001000041000054000001042e0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000075a0000c13d000018140000013d001b00000000001d0000150401100197000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a0000157900100198000010cd0000c13d0000001b01000029000015070010009c00000e910000a13d000014870000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000cac0000c13d000018140000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d1f0000c13d000018140000013d0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150401100197000000020010008c001b00000000001d000011340000413d001b00000000001d000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a0000150401100197000000010010008c0000111e0000213d0000001b01000029000015070010009c000014870000213d0000001b0100002900000005011002100000003f021000390000157803200197000000400200043d001a00000002001d0000000002230019000000000032004b00000000030000390000000103004039000015070020009c000014870000213d0000000100300190000014870000c13d000000400020043f0000001a020000290000001b030000290000000002320436001900000002001d0000001f0210018f000000000001004b000011520000613d0000001904000029000000000114001900000000030000310000001203300367000000003503043c0000000004540436000000000014004b0000114e0000c13d000000000002004b0000000101000039000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000157900100198000011800000613d00000000030000190000001a020000290000000002020433000000000032004b00001d4f0000a13d001b00000003001d0000000502300210000000190220002900001504011001970000000000120435000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b030000290000000103300039000000000101043b000000000101041a0000157900100198000011650000c13d000000400100043d001b00000001001d0000001a0200002953ff3a580000040f0000001b020000290000000001210049000015010010009c00001501010080410000006001100210000015010020009c00001501020080410000004002200210000000000121019f000054000001042e000015f8012001970000000000140435000000000005004b000000200200003900000000020060390000003f01200039000000200500008a000000000151016f0000000009710019000000000019004b00000000010000390000000101004039000015070090009c000014870000213d0000000100100190000014870000c13d000000400090043f0000000001070433000000020010008c000013990000813d000000000600001900000005016002100000003f0210003900001578022001970000000002920019000015070020009c000014870000213d000000400020043f0000000005690436000000000006004b000011b40000613d00000060020000390000000003000019000000000435001900000000002404350000002003300039000000000013004b000011af0000413d001a00000005001d000000400100043d000015860010009c000014870000213d001900000009001d0000004002100039000000400020043f000000010200003900000000012104360000000000010435000000400100043d0000000102100039000015a80300004100000000003204350000000002010433000015cf022001970000000000210435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015d1011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001b00000004001d0000001f0040008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001800000004001d0000001b050000290000000004540436001700000004001d000000000003004b00001b880000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b05000029000000000005004b0000000002000019000000170600002900001b8e0000613d000000000101043b00000000020000190000000003260019000000000401041a000000000043043500000001011000390000002002200039000000000052004b000011f60000413d00001b8e0000013d000000000061041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000303000039000015da0400004153ff53eb0000040f0000000100200190000000880000613d0000000001000019000054000001042e0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000009ba0000c13d000018140000013d000000000001004b000017020000613d0000001b01000029000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000d330000613d0000000101000039001a00000001001d000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c000012340000c13d0000001b01000029000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000001b0100002953ff535e0000040f00000004030000390000000001000414000000400200043d000000000332043600001585040000410000000000430435000015860020009c000014870000213d0000004004200039000000400040043f001a00000004001d000015870040009c000014870000213d0000006004200039000000400040043f0000001a0400002900000000000404350000001b04000029000000040040008c000012a20000613d000015010030009c000015010300804100000040033002100000000002020433000015010020009c00001501020080410000006002200210000000000232019f000015010010009c0000150101008041000000c001100210000000000112019f0000001b0200002953ff53eb0000040f0000006002100270000115010020019d00130000000103550000001a01000029000000000001043500000000010004140000001b020000290000150405200197000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015880400004100000dc70000013d000015010050009c000015010500804100000040035002100000000001010433000015010010009c00001501010080410000006001100210000000000131019f0000157f011001c753ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000012c70000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000012c30000c13d000000000005004b000012d40000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f001300000001035500000001002001900000203d0000613d000000000100043d000000200030008c0000203d0000413d000000000001004b0000203d0000613d000000400100043d00000020021000390000157e040000410000000000420435000000240410003900001580050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001b04000029000000040040008c0000171f0000c13d0000000001020433000000000010043f000017510000013d000015f802200197000000a00020043f000000000001004b00000020020000390000000002006039000014830000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000026f0000c13d000018140000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000003f60000c13d000018140000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000018140000613d000000400200043d000015860020009c00000b920000a13d000014870000013d00000000032100a900000000022300d9000000000012004b000038d60000c13d00000000010004150000001e0110008a001b0005001002180000000001000414000000000003004b00000db20000613d000015010010009c0000150101008041000000c00110021000001574011001c700008009020000390000800104000039000000000500001953ff53eb0000040f00000000030004150000001e0330008a001b00050030021800000db70000013d001b00000000001d0000150401100197000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029001b00010020003d000000000101043b000000000101041a00001579001001980000134c0000c13d0000001b01000029000015070010009c00000f6c0000a13d000014870000013d0000002002500039000000000221034f000015f6043001980000001f0530018f00000080014000390000136f0000613d0000008006000039000000000702034f000000007807043c0000000006860436000000000016004b0000136b0000c13d000000000005004b0000137c0000613d000000000242034f0000000304500210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f00000000002104350000008001300039000015a80200004100000000002104350000002002300039000000800100003953ff53b80000040f000000000101041a53ff3acf0000040f00000f000000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000dfe0000c13d000018140000013d0000000006000019001b00000006001d000000000451016f0000001f0310018f0000002002700039000000000092004b000013b00000813d000000000004004b000013ac0000613d00000000063200190000000005390019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000013a60000c13d000000000003004b000013c60000613d0000000005090019000013bc0000013d0000000005490019000000000004004b000013b90000613d0000000006020019000000000709001900000000680604340000000007870436000000000057004b000013b50000c13d000000000003004b000013c60000613d00000000024200190000000303300210000000000405043300000000043401cf000000000434022f00000000020204330000010003300089000000000232022f00000000023201cf000000000242019f00000000002504350000000002910019000015a8030000410000000000320435000015010090009c000015010900804100000040029002100000002001100039000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001052002700000007f0550618f0000001f0050008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400700043d0000000004570436000000000003004b000014080000613d001800000004001d001900000005001d001a00000007001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001908000029000000000008004b0000001b06000029000014100000613d000000000201043b0000000001000019000000200500008a0000001a0700002900000018090000290000000003190019000000000402041a000000000043043500000001022000390000002001100039000000000081004b000014000000413d000014130000013d000015f8012001970000000000140435000000000005004b00000020010000390000000001006039000000200500008a0000001b06000029000014130000013d0000000001000019000000200500008a0000001a070000290000003f01100039000000000151016f0000000009710019000000000019004b00000000010000390000000101004039000015070090009c000014870000213d0000000100100190000014870000c13d000000400090043f00000001066000390000000001070433000000020010008c0000139a0000813d000015070060009c000011a30000a13d000014870000013d0000157501000041000000000010043f000015710100004100005401000104300000000101000039001a00000001001d000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504011001970000001b0010006c0000142a0000c13d0000001b01000029000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001900000001001d0000001a01000029000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019020000290000150402200197000000000101043b000000000301041a0000157c03300197000000000223019f000000000021041b0000001b01000029000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d0200003900000002030000390000157d0400004100001c000000013d00001592030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000147c0000413d0000003f01200039000015f601100197000015a30010009c0000148d0000a13d000015d701000041000000000010043f0000004101000039000000040010043f0000159801000041000054010001043000000000050100190000008006100039000000400060043f0000159401000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d001b00000006001d0000000000160435000000000003004b001900000005001d000016980000613d0000159402000041000000000020043f000000000001004b00000000020000190000169e0000613d000015cb030000410000001902000029000000a00420003900000000020000190000000005240019000000000603041a000000000065043500000001033000390000002002200039000000000012004b000014a90000413d0000169e0000013d001400440090003d000000000c000019000000000b000019001600000009001d001500000008001d00000000049200490000000503c00210000000000e8300190000000003e1034f000000000303043b000000a30440008a00001556054001970000155606300197000000000756013f000000000056004b00000000050000190000155605004041000000000043004b00000000040000190000155604008041000015560070009c000000000504c019000000000005004b000000880000c13d00000000058300190000004003500039000000000331034f000000000303043b0000000000b3001a000038d60000413d000000000451034f000000000404043b000015040040009c000000880000213d0000006006500039000000000761034f00000000065200490000001f0660008a000080060040008c001b0000000b001d001a0000000c001d001900000003001d00180000000e001d0000153e0000c13d000000000d000414000000000407043b00001556076001970000155608400197000000000978013f000000000078004b00000000070000190000155607004041000000000064004b00000000060000190000155606008041000015560090009c000000000706c019000000000007004b000000880000c13d0000000005540019000000000451034f000000000404043b000015070040009c000000880000213d0000000006420049000000200750003900001556056001970000155608700197000000000958013f000000000058004b00000000050000190000155605004041000000000067004b00000000060000190000155606002041000015560090009c000000000506c019000000000005004b000000880000c13d0000001f05400039000015f6055001970000003f05500039000015f606500197000000400500043d0000000006650019000000000056004b00000000080000390000000108004039000015070060009c000014870000213d0000000100800190000014870000c13d000000400060043f00000000064504360000000008740019000000000028004b000000880000213d000000000271034f000015f60740019800000000017600190000151c0000613d000000000802034f0000000009060019000000008a08043c0000000009a90436000000000019004b000015180000c13d0000001f08400190000015290000613d000000000272034f0000000307800210000000000801043300000000087801cf000000000878022f000000000202043b0000010007700089000000000272022f00000000027201cf000000000282019f0000000000210435000000000146001900000000000104350000000001050433000015010010009c00001a360000213d000000c002d002100000155c0220019700000040045002100000155d0440009a0000155e04400197000000000242019f00000060011002100000155f01100197000000000112019f00001560011001c7000000000003004b000015920000613d000080090200003900008006040000390000000105000039000015960000013d000000000d000414000000000707043b00001556086001970000155609700197000000000a89013f000000000089004b00000000080000190000155608004041000000000067004b000000000600001900001556060080410000155600a0009c000000000806c019000000000008004b000000880000c13d0000000006570019000000000561034f000000000505043b000015070050009c000000880000213d0000000007520049000000200660003900001556087001970000155609600197000000000a89013f000000000089004b00000000080000190000155608004041000000000076004b000000000700001900001556070020410000155600a0009c000000000807c019000000000008004b000000880000c13d000000000003004b0000157b0000613d000000000005004b0000156d0000613d00001501076001970002000000710355000000000065001a000038d60000413d0000000005650019000000000252004b000038d60000413d000000000171034f000015010220019700020000002103e50000155b00d0009c00001a360000813d00000000012103df000000c002d002100000155c0220019700001567022001c700020000002103b500000000012103af000080090200003900000000050000190000000006000019000015900000013d000000000005004b000015850000613d00001501076001970002000000710355000000000065001a000038d60000413d0000000005650019000000000252004b000038d60000413d000000000171034f000015010220019700020000002103e50000150100d0009c00001a360000213d00000000012103df000000c002d002100000155c0220019700001568022001c700020000002103b500000000012103af000000000204001953ff53f50000040f000015980000013d0000800602000039000000000300001900000000040000190000000005000019000000000600001953ff53eb0000040f000000000302001900130000000103550000006001100270000115010010019d00000012010003670000001802100360000000000402043b000000000200003100000016090000290000000005920049000000a30550008a00001556065001970000155607400197000000000867013f000000000067004b00000000060000190000155606004041000000000054004b00000000050000190000155605008041000015560080009c000000000605c019000000000006004b00000015080000290000001b0b0000290000001a0c0000290000001906000029000000880000c13d0000001404400029000000000441034f000000000404043b000000000004004b0000000005000039000000010500c039000000000054004b000000880000c13d000000000004004b000000010330c1bf000000010030019000001a1e0000613d000000000bb60019000000010cc000390000001700c0006c000014b60000413d0000073f0000013d000015f8012001970000000000140435000000000006004b000000200200003900000000020060390000002002200039000000000105001953ff3a460000040f000000400100043d001a00000001001d0000001b0200002953ff3a9a0000040f0000001a02000029000011850000013d0000150401100197000000020010008c000017020000413d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000003520000c13d000018140000013d0000001504000029000001e4024000390000001201000367000000000221034f000000000202043b00000000030000310000000004430049000000230440008a00001556054001970000155606200197000000000756013f000000000056004b00000000050000190000155605004041000000000042004b00000000040000190000155604008041000015560070009c000000000504c019000000000005004b000000880000c13d0000001b04200029000000000241034f000000000202043b000015070020009c000000880000213d0000000005230049000000200340003900001556045001970000155606300197000000000746013f000000000046004b00000000040000190000155604004041000000000053004b00000000050000190000155605002041000015560070009c000000000405c019000000000004004b000000880000c13d000000200020008c000000880000413d000000000431034f000000000404043b000015070040009c000000880000213d00000000023200190000000003340019001a00000003001d0000001f03300039000000000023004b0000000005000019000015560500804100001556033001970000155604200197000000000643013f000000000043004b00000000030000190000155603004041000015560060009c000000000305c019000000000003004b000000880000c13d0000001a03100360000000000503043b000015070050009c000014870000213d00000005065002100000003f036000390000155703300197000000400800043d0000000007380019000500000008001d000000000087004b00000000030000390000000103004039000015070070009c000014870000213d0000000100300190000014870000c13d000000400070043f00000005030000290000000003530436000400000003001d0000001a030000290000002005300039001900000056001d000000190020006b000000880000213d000000190050006c000022740000813d00000005080000290000164c0000013d0000002008800039000000000393001900000000000304350000000000a804350000002005500039000000190050006c000022740000813d000000000351034f000000000303043b000015070030009c000000880000213d0000001a0b3000290000003f03b00039000000000023004b000000000900001900001556090080410000155603300197000000000a43013f000000000043004b000000000300001900001556030040410000155600a0009c000000000309c019000000000003004b000000880000c13d000000200cb000390000000003c1034f000000000903043b000015070090009c000014870000213d0000001f03900039000015f6033001970000003f03300039000015f603300197000000400a00043d000000000d3a00190000000000ad004b000000000300003900000001030040390000150700d0009c000014870000213d0000000100300190000014870000c13d000000400bb000390000004000d0043f00000000039a0436000000000bb9001900000000002b004b000000880000213d000000200bc00039000000000db1034f000015f60e900198000000000ce30019000016810000613d000000000f0d034f000000000b03001900000000f60f043c000000000b6b04360000000000cb004b0000167d0000c13d0000001f0b900190000016450000613d0000000006ed034f000000030bb00210000000000d0c0433000000000dbd01cf000000000dbd022f000000000606043b000001000bb000890000000006b6022f0000000006b601cf0000000006d6019f00000000006c0435000016450000013d000015010050009c000015010500804100000040015002100000000002040433000015010020009c00001501020080410000006002200210000000000112019f0000540100010430000015f802200197000000a0035000390000000000230435000000000001004b000000200200003900000000020060390000003f01200039000015f6011001970000001b02100029000000000012004b00000000010000390000000101004039001a00000002001d000015070020009c000014870000213d0000000100100190000014870000c13d0000001a01000029000000400010043f000015870010009c000014870000213d0000001a020000290000002001200039000000400010043f0000000000020435000000400100043d001800000001001d000015cc0100004100000000001004430000000001000414000015010010009c0000150101008041000000c001100210000015cd011001c70000800b0200003953ff53f00000040f000000010020019000003a060000613d000000000101043b00000018040000290000002002400039000000e0030000390000000000320435000015ce020000410000000000240435000000e002400039000000800300043d0000000000320435000015f6053001970000001f0230018f0000010004400039000000a10040008c00001a470000413d000000000005004b000016d80000613d000000000724001900000080062001bf000000200770008a0000000008570019000000000956001900000000090904330000000000980435000000200550008c000016d20000c13d000000000002004b00001a5d0000613d000000a005000039000000000604001900001a530000013d0000001b01000029000015650010009c000017690000c13d000015d201000041000000000010043f000015710100004100005401000104300000001a010000290000002001100039001700000001001d0000001201100367000000000301043b000000400100043d00000020021000390000157e0400004100000000004204350000002405100039000000000045043500000024040000390000000000410435001a006000300278000000190000006b000017f90000c13d0000155a0010009c000014870000213d0000006003100039000000400030043f0000001a03000029000000040030008c00001ab50000c13d0000000001020433000000000010043f000000010300003100001ae00000013d0000150401100197000000020010008c000018040000813d000015f001000041000000000010043f000015710100004100005401000104300000001b010000290000012401100039000000000113034f000000000101043b001700000001001d000015ea010000410000000000100443000000000100041000000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c70000800a0200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000170010006b0000182d0000a13d000015ee01000041000000000010043f00001571010000410000540100010430000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000017380000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000017340000c13d000000000005004b000017450000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350013000000010355000100000003001f0000001f0030008c00000000010000390000000101002039000000000112016f0000000002000415000000210220008a0019000500200218000000010010008c000017560000c13d000000000100043d0000000002000415000000200220008a0019000500200218000000000001004b0000203d0000c13d000000400100043d00000020021000390000157e040000410000000000420435000000240410003900001581050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001b04000029000000040040008c000019b70000c13d0000000001020433000000000010043f000019e20000013d0000001701000029000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000001b02000029000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b001b00000001001d000000000101041a000000010010019000000001021002700000007f0220618f001700000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d0000001701000029000000200010008c000017af0000413d0000001b01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001a030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000017010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000017af0000813d000000000002041b0000000102200039000000000012004b000017ab0000413d0000001a010000290000001f0010008c00001df80000a13d0000001b01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000200200008a0000001a02200180000000000101043b0000216d0000c13d0000000003000019000021780000013d0000000101000039001b00000001001d000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a001a00000001001d0000001b01000029000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c02200197000000000021041b0000001a010000290000150401100197000000010010008c000017c40000213d0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000103000039000015d80400004153ff53eb0000040f0000000100200190000000880000613d0000001501000029000000160200002953ff4c890000040f0000000001000019000054000001042e0000155a0010009c000014870000213d0000006003100039000000400030043f0000001a03000029000000040030008c00001af70000c13d0000000001020433000000000010043f000000010300003100001b220000013d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800000ae10000c13d000015e001000041000000000010043f00001571010000410000540100010430000000000651034f000000000606043b0000158006600197000015ab0060009c0000120a0000613d000015ac0060009c00001a220000c13d000000430040008c00001bb10000213d0000156c01000041000000800010043f0000002001000039000000840010043f0000004001000039000000a40010043f000015bb01000041000000c40010043f000015bc01000041000000e40010043f000015bd010000410000540100010430000000180000006b000018320000c13d0000001a0100002953ff3bfa0000040f001800000001001d000000190100002900000100021000390000001201000367000000000221034f000000000202043b00000000030000310000001b0430006a000000230440008a00001556054001970000155606200197000000000756013f000000000056004b00000000050000190000155605004041000000000042004b00000000040000190000155604008041000015560070009c000000000504c019000000000005004b000000880000c13d0000001a04200029000000000241034f000000000202043b000015070020009c000000880000213d0000000003230049000000200440003900001556053001970000155606400197000000000756013f000000000056004b00000000050000190000155605004041000000000034004b00000000030000190000155603002041000015560070009c000000000503c019000000000005004b000000880000c13d000000410020008c000000000300001900001e060000c13d000000400100043d0000000000310435000015010010009c0000150101008041000000400110021000001552011001c7000054000001042e000000150000006b000018750000c13d0000158b0110019700000001011001bf0000158c021001970000158d022001c7000000150000006b000000000201c0190000150501000041000000000021041b000015060020019800001b390000c13d000015a101000041000000000010043f00001571010000410000540100010430000015a201000041000000000010043f00001571010000410000540100010430000000400100043d001b00000001001d000015860010009c000014870000213d0000001b020000290000004001200039000000400010043f00000001010000390000000005120436000000140100002900000003021002100000010001200089000b00000002001d000f15f700200287000c00000001001d000e15f70010022700000017010000290000001f01100039000015f601100197000d00000001001d0000003f01100039001215f60010019b00000000000504350000001b010000290000000009050019001000000001001d0000000001010433000015f6041001970000001f0310018f000000400200043d000000000025004b000018aa0000813d000000000004004b000018a50000613d00000000063900190000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c0000189f0000c13d000000000003004b000018c00000613d00000000040900190000000005020019000018b60000013d0000000005420019000000000004004b000018b30000613d0000000006090019000000000702001900000000680604340000000007870436000000000057004b000018af0000c13d000000000003004b000018c00000613d00000000044900190000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f0000000000350435001100000009001d0000000003210019000015a8040000410000000000430435000015010020009c000015010200804100000040022002100000002001100039000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001052002700000007f0550618f0000001f0050008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001b00000004001d0000000004540436000000000003004b001a00000004001d000019000000613d001900000005001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000001a050000290000000100200190000000880000613d0000001906000029000000000006004b000019060000613d000000000201043b00000000010000190000000003150019000000000402041a000000000043043500000001022000390000002001100039000000000061004b000018f80000413d000019070000013d000015f8012001970000000000140435000000000005004b00000020010000390000000001006039000019070000013d00000000010000190000003f01100039000015f6021001970000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f0000001202100029000015070020009c000014870000213d000000400020043f000000170200002900000000022104360000001604000029000000000040007c000000880000213d000000150300002900000012043003670000001803200029000000180000006b000019260000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b000019220000c13d000000140000006b0000192f0000613d00000000050304330000000f0550017f0000001804400360000000000404043b0000000e0440017f000000000454019f000000000043043500000013031000290000000000030435000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f00000001002001900000001a02000029000000880000613d000015010020009c000015010200804100000040022002100000001b030000290000000003030433000015010030009c00001501030080410000006003300210000000000223019f000000000101043b001900000001001d0000000001000414000015010010009c0000150101008041000000c001100210000000000121019f00001574011001c7000080100200003953ff53f00000040f0000001a050000290000000100200190000000880000613d000000000101043b000000190010006c000018900000c13d0000001b010000290000000001010433000015f6041001970000001f0310018f000000400200043d000000000025004b000020500000813d000000000004004b000019700000613d0000001a063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c0000196a0000c13d000000000003004b000020660000613d0000001a0400002900000000050200190000205c0000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f00000020044001900000198e0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000198a0000c13d000000000005004b0000199b0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f001300000001035500000001002001900000203d0000613d000000000100043d000000200030008c0000203d0000413d000000000001004b0000203d0000613d000000400100043d00000020021000390000157e040000410000000000420435000000240410003900001580050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001b04000029000000040040008c00001c020000c13d0000000001020433000000000010043f00001c340000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000019d00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000019cc0000c13d000000000005004b000019dd0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f001300000001035500000001002001900000203a0000613d000000000100043d000000200030008c0000203a0000413d000000000001004b00000019010000290000000501100270000000000100003f000000010100c03f00000000010004150000001a011000690000000001000002000020400000613d0000001b01000029000000020010008c000017020000413d0000001b01000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000028760000c13d0000158301000041000000000201041a0000157c032001970000001b04000029000000000343019f000000000031041b000000000040043f0000158201000041000000200010043f001a15040020019c0000218c0000c13d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d001a00010000003d000021950000013d00000000010004100000001b0010006b00001b770000c13d000015a601000041000000000010043f00001571010000410000540100010430000015c401000041000000000010043f000015710100004100005401000104300000156c01000041000000800010043f0000002001000039000000840010043f0000001a01000039000000a40010043f000015be01000041000000c40010043f000015bf0100004100005401000104300000000401200360000000000401043b000015040040009c000000880000213d0000000401000029000000e001100039000000000312034f000000000303043b000015660030009c00001c4c0000a13d000000400100043d00000044021000390000156d0300004100000000003204350000002402100039000000080300003900000000003204350000156c020000410000000000210435000000040210003900000020030000390000000000320435000015010010009c000015010100804100000040011002100000156e011001c700005401000104300000000006540019000000000005004b00001a500000613d000000a007000039000000000804001900000000790704340000000008980436000000000068004b00001a4c0000c13d000000000002004b00001a5d0000613d000000a0055000390000000302200210000000000706043300000000072701cf000000000727022f00000000050504330000010002200089000000000525022f00000000022501cf000000000272019f00000000002604350000000002000410000000000543001900000000000504350000001f03300039000015f603300197000000000343001900000018050000290000000004530049000000400550003900000000004504350000001b0400002900000000040404330000000003430436000015f6074001970000001f0640018f0000001905000029000000a005500039000000000035004b00001a800000813d000000000007004b00001a7c0000613d00000000096500190000000008630019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c00001a760000c13d000000000006004b00001a960000613d000000000803001900001a8c0000013d0000000008730019000000000007004b00001a890000613d0000000009050019000000000a030019000000009b090434000000000aba043600000000008a004b00001a850000c13d000000000006004b00001a960000613d00000000057500190000000306600210000000000708043300000000076701cf000000000767022f00000000050504330000010006600089000000000565022f00000000056501cf000000000575019f0000000000580435000000000534001900000000000504350000150402200197000000180600002900000080056000390000000000250435000000600260003900000000001204350000001f01400039000015f60110019700000000013100190000000002610049000000c0036000390000000000230435000000a00260003900000000000204350000001a0200002900000000020204330000000001210436000000000002004b00001ab30000613d00000000030000190000001a050000290000002005500039000000000405043300000000014104360000000103300039000000000023004b00001aad0000413d0000001802000029000011850000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001a0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001ace0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001aca0000c13d000000000005004b00001adb0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00130000000103550000000100200190000021690000613d000000000100043d000000200030008c000021690000413d000000000001004b000021690000613d000000400100043d00000020021000390000157e040000410000000000420435000000240410003900001580050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001a04000029000000040040008c00001ed20000c13d0000000001020433000000000010043f00001f010000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001a0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001b100000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001b0c0000c13d000000000005004b00001b1d0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00130000000103550000000100200190000021690000613d000000000100043d000000200030008c000021690000413d000000000001004b000021690000613d000000400100043d00000020021000390000157e040000410000000000420435000000240410003900001580050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001a04000029000000040040008c00001f160000c13d0000000001020433000000000010043f00001f450000013d000000400100043d000015860010009c000014870000213d0000004002100039000000400020043f000000140200003900000000032104360000158e020000410000000000230435000000400200043d001400000002001d000015860020009c000014870000213d00000014040000290000004002400039000000400020043f000000050200003900000000042404360000158f02000041001300000004001d00000000002404350000000002010433000015070020009c000014870000213d0000159004000041000000000504041a000000010050019000000001045002700000007f0440618f0000001f0040008c00000000060000390000000106002039000000000565013f0000000100500190000008d40000c13d000000200040008c00001b6e0000413d0000159005000041000000000050043f0000001f052000390000000505500270000015910550009a000000200020008c00001592050040410000001f044000390000000504400270000015910440009a000000000045004b00001b6e0000813d000000000005041b0000000105500039000000000045004b00001b6a0000413d0000001f0020008c000021a30000a13d0000159003000041000000000030043f000015f605200198000024b10000c13d00000020040000390000159203000041000024bd0000013d000000800200043d00000000010004140000001b03000029000000040030008c0000120a0000613d000015010020009c00001501020080410000006002200210000015010010009c0000150101008041000000c001100210000000000121019f0000001a0000006b00001dd40000c13d000015a5011001c70000001b0200002900001dd90000013d000015f801200197000000170200002900000000001204350000001b0000006b000000200200003900000000020060390000003f01200039000000200500008a000000000251016f00000018070000290000000001720019000000000021004b00000000020000390000000102004039000015070010009c0000001906000029000014870000213d0000000100200190000014870000c13d000000400010043f0000000002070433000000020020008c00001cb80000813d0000002002000039000000000321043600000000020604330000000000230435000000400310003900000005042002100000000005340019000000000002004b00001f5a0000c13d0000000002150049000015010020009c00001501020080410000006002200210000015010010009c00001501010080410000004001100210000000000112019f000054000001042e0000000404500039000000000541034f000000000505043b001b00000005001d000015040050009c000000880000213d000001400330008a000000000331034f0000002004400039000000000441034f000000000404043b001a00000004001d000000000303043b000015ad04000041000000800040043f00000000040004100000150404400197001800000004001d000000840040043f0000150403300197001900000003001d000000a40030043f00000000030004140000001b04000029000000040040008c00001f970000c13d000000000121034f0000000103000031000000200030008c0000002004000039000000000403401900001fbd0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001bd80000c13d000000000005004b00001be90000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015010020009c00001501020080410000004002200210000000000112019f00005401000104300000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015d40400004100001c000000013d0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015c7040000410000001b0500002900000dc70000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001c1b0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001c170000c13d000000000005004b00001c280000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350013000000010355000100000003001f0000001f0030008c00000000010000390000000101002039000000000112016f0000000002000415000000230220008a0019000500200218000000010010008c00001c390000c13d000000000100043d0000000002000415000000220220008a0019000500200218000000000001004b0000203d0000c13d000000400100043d00000020021000390000157e0400004100000000004204350000002404100039000015dc050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001b04000029000000040040008c00001fe20000c13d0000000001020433000000000010043f0000200d0000013d000000a001100039000000000112034f000000000101043b0000000005000031000000050650006a000000230660008a00001556076001970000155608100197000000000978013f000000000078004b00000000070000190000155607004041000000000061004b00000000060000190000155606008041000015560090009c000000000706c019000000000007004b000000880000c13d0000001b01100029000000000612034f000000000606043b000015070060009c000000880000213d0000000008650049000000200710003900001556018001970000155609700197000000000a19013f000000000019004b00000000010000190000155601004041000000000087004b000000000800001900001556080020410000155600a0009c000000000108c019000000000001004b000000880000c13d0000000001000414000015010010009c00001a360000213d000080060040008c000025340000c13d0000001f04600039000015f6044001970000003f04400039000015f608400197000000400400043d0000000008840019000000000048004b00000000090000390000000109004039000015070080009c000014870000213d0000000100900190000014870000c13d000000400080043f00000000086404360000000009760019000000000059004b000000880000213d000000000572034f000015f6076001980000001f0960018f000000000278001900001c950000613d000000000a05034f000000000b08001900000000ac0a043c000000000bcb043600000000002b004b00001c910000c13d000000000009004b00001ca20000613d000000000575034f0000000307900210000000000902043300000000097901cf000000000979022f000000000505043b0000010007700089000000000575022f00000000057501cf000000000595019f0000000000520435000000000268001900000000000204350000000002040433000015010020009c00001a360000213d000000c0011002100000155c0110019700000040044002100000155d0440009a0000155e04400197000000000141019f00000060022002100000155f02200197000000000121019f00001560011001c7000000000003004b000028d90000c13d0000800602000039000000000300001900000000040000190000000005000019000028dc0000013d00000000030000190000000001060433000000000031004b00001d4f0000a13d00000005013002100000001a0110002900000000007104350000000001060433000000000031004b00001d4f0000a13d001b00000003001d0000000001070433000000000551016f0000001f0410018f0000002003700039000000400200043d000000000023004b00001cda0000813d000000000005004b00001cd60000613d00000000074300190000000006420019000000200660008a000000200770008a0000000008560019000000000957001900000000090904330000000000980435000000200550008c00001cd00000c13d000000000004004b00001cf00000613d000000000602001900001ce60000013d0000000006520019000000000005004b00001ce30000613d0000000007030019000000000802001900000000790704340000000008980436000000000068004b00001cdf0000c13d000000000004004b00001cf00000613d00000000035300190000000304400210000000000506043300000000054501cf000000000545022f00000000030304330000010004400089000000000343022f00000000034301cf000000000353019f00000000003604350000000003210019000015a8040000410000000000430435000015010020009c000015010200804100000040022002100000002001100039000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001052002700000007f0550618f0000001f0050008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400700043d0000000004570436000000000003004b00001d320000613d001600000004001d001700000005001d001800000007001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001708000029000000000008004b00001d3a0000613d000000000201043b0000000001000019000000200500008a0000001906000029000000180700002900000016090000290000000003190019000000000402041a000000000043043500000001022000390000002001100039000000000081004b00001d2a0000413d00001d3e0000013d000015f8012001970000000000140435000000000005004b00000020010000390000000001006039000000200500008a000000190600002900001d3e0000013d0000000001000019000000200500008a000000190600002900000018070000290000003f01100039000000000251016f0000000001720019000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f0000001b0300002900000001033000390000000002070433000000020020008c00001cb90000813d00001b9f0000013d000015d701000041000000000010043f0000003201000039000000040010043f000015980100004100005401000104300000001806500029000000000005004b00001d5e0000613d0000000007020019000000180800002900000000790704340000000008980436000000000068004b00001d5a0000c13d000000000004004b00001d6b0000613d00000000025200190000000304400210000000000506043300000000054501cf000000000545022f00000000020204330000010004400089000000000242022f00000000024201cf000000000252019f000000000026043500000018011000290000000000010435000000c00100043d001700000001001d000015040010009c000000880000213d000000400100043d000015870010009c000014870000213d0000002002100039000000400020043f0000000000310435000000400100043d0000004002100039000000000032043500000040020000390000000002210436000015c90300004100000000003204350000155a0010009c000014870000213d0000006003100039000000400030043f000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b53ff3b070000040f001500000001001d0000001701000029000000020010008c00001dd00000413d00000017010000290000157900100198000017020000613d0000001701000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000273f0000c13d0000001701000029000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000029670000c13d0000001701000029000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a000015040010019800002ade0000c13d0000000002000019000000400100043d0000000000210435000018600000013d000015a4011001c700008009020000390000001a030000290000001b04000029000000000500001953ff53eb0000040f00130000000103550000006003100270000115010030019d00000001002001900000120a0000c13d00001501023001970000001f0420018f000015030320019800001de90000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000036004b00001de50000c13d000000000004004b00001df60000613d000000000131034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000600120021000005401000104300000001a0000006b000000000100001900001dff0000613d000000190100002900000020011000390000001201100367000000000101043b0000001a040000290000000302400210000015f70220027f000015f702200167000000000221016f0000000101400210000021870000013d000000600020008c000000880000413d000000000341034f000000000303043b000015070030009c000000880000213d000000000242001900000000064300190000001f03600039000000000023004b0000000005000019000015560500804100001556073001970000155603200197000000000837013f000000000037004b00000000070000190000155607004041000015560080009c000000000705c019000000000007004b000000880000c13d000000000561034f000000000505043b000015070050009c000014870000213d0000001f07500039000015f6077001970000003f07700039000015f607700197000000400800043d0000000007780019000300000008001d000000000087004b00000000080000390000000108004039000015070070009c000014870000213d0000000100800190000014870000c13d0000002006600039000000400070043f00000003070000290000000007570436000200000007001d0000000007650019000000000027004b000000880000213d000000000761034f000015f6085001980000001f0950018f000000020680002900001e410000613d000000000a07034f000000020b00002900000000ac0a043c000000000bcb043600000000006b004b00001e3d0000c13d000000000009004b00001e4e0000613d000000000787034f0000000308900210000000000906043300000000098901cf000000000989022f000000000707043b0000010008800089000000000787022f00000000078701cf000000000797019f0000000000760435000000020550002900000000000504350000002005400039000000000651034f000000000606043b000100000006001d000015040060009c000000880000213d0000002005500039000000000551034f000000000505043b000015070050009c000000880000213d0000000004450019001b00000004001d0000001f05400039000000000025004b000000000600001900001556060080410000155605500197000000000735013f000000000035004b00000000050000190000155605004041000015560070009c000000000506c019000000000005004b000000880000c13d0000001b05100360000000000505043b000015070050009c000014870000213d00000005065002100000003f076000390000155707700197000000400400043d0000000007740019001400000004001d000000000047004b00000000080000390000000108004039000015070070009c000014870000213d0000000100800190000014870000c13d000000400070043f00000014040000290000000004540436001300000004001d0000001b0400002900000020054000390000000006560019000000000026004b000000880000213d000000000065004b00002fd60000813d000000140700002900001e8f0000013d000000200770003900000000048a0019000000000004043500000000009704350000002005500039000000000065004b00002fd60000813d000000000851034f000000000808043b000015070080009c000000880000213d0000001b0a8000290000003f08a00039000000000028004b000000000900001900001556090080410000155608800197000000000b38013f000000000038004b000000000800001900001556080040410000155600b0009c000000000809c019000000000008004b000000880000c13d000000200ba000390000000008b1034f000000000808043b000015070080009c000014870000213d0000001f09800039000015f6099001970000003f09900039000015f60c900197000000400900043d000000000cc9001900000000009c004b000000000d000039000000010d0040390000150700c0009c000014870000213d0000000100d00190000014870000c13d000000400da000390000004000c0043f000000000a890436000000000cd8001900000000002c004b000000880000213d000000200bb00039000000000cb1034f000015f60d800198000000000bda001900001ec40000613d000000000e0c034f000000000f0a001900000000e40e043c000000000f4f04360000000000bf004b00001ec00000c13d0000001f0e80019000001e880000613d0000000004dc034f000000030ce00210000000000d0b0433000000000dcd01cf000000000dcd022f000000000404043b000001000cc000890000000004c4022f0000000004c401cf0000000004d4019f00000000004b043500001e880000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001a0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001eeb0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001ee70000c13d000000000005004b00001ef80000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350013000000010355000100000003001f0000001f0030008c00000000010000390000000101002039000000000112016f000000010010008c00001f030000c13d000000000100043d000000000001004b000021690000c13d000000400100043d00000020021000390000157e0400004100000000004204350000002404100039000015e1050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001a04000029000000040040008c000020a70000c13d0000000002020433000000000020043f000020d20000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001a0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001f2f0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001f2b0000c13d000000000005004b00001f3c0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350013000000010355000100000003001f0000001f0030008c00000000010000390000000101002039000000000112016f000000010010008c00001f470000c13d000000000100043d000000000001004b000021690000c13d000000400100043d00000020021000390000157e04000041000000000042043500000024041000390000156f050000410000000000540435000000240400003900000000004104350000155a0010009c000014870000213d0000006004100039000000400040043f0000001a04000029000000040040008c000020d60000c13d0000000002020433000000000020043f000021010000013d0000000004000019000000190f00002900001f6f0000013d000000030880021000000000090a043300000000098901cf000000000989022f00000000070704330000010008800089000000000787022f00000000078701cf000000000797019f00000000007a04350000001f07600039000015f6077001970000000006560019000000000006043500000000055700190000000104400039000000000024004b00001ba80000813d0000000006150049000000400660008a0000000003630436000000200ff0003900000000060f043300000000760604340000000005650436000015f6096001970000001f0860018f000000000057004b00001f8a0000813d000000000009004b00001f860000613d000000000b870019000000000a850019000000200aa0008a000000200bb0008a000000000c9a0019000000000d9b0019000000000d0d04330000000000dc0435000000200990008c00001f800000c13d000000000008004b00001f670000613d000000000a05001900001f5d0000013d000000000a950019000000000009004b00001f930000613d000000000b070019000000000c05001900000000bd0b0434000000000cdc04360000000000ac004b00001f8f0000c13d000000000008004b00001f670000613d000000000797001900001f5d0000013d000015010030009c0000150103008041000000c001300210000015ae011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000000800a00003900001fac0000613d000000000801034f000000008908043c000000000a9a043600000000005a004b00001fa80000c13d000000000006004b00001fb90000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000020440000613d0000001f02400039000000600420018f00000080024001bf000000400020043f000000200030008c000000880000413d000000800500043d0000001a0050006c0000120a0000813d000000a005400039000015af060000410000000000650435000000a40640003900000019070000290000000000760435000000c4064000390000000000060435000000440600003900000000006204350000014006400039000000400060043f0000012006400039000015b007000041000000000076043500000100064001bf0000002004000039001600000006001d0000000000460435000000000402043300000000020004140000001b06000029000000040060008c000021ae0000c13d000015070030009c000014870000213d0000000102000039000021c20000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001ffb0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001ff70000c13d000000000005004b000020080000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f001300000001035500000001002001900000203a0000613d000000000100043d000000200030008c0000203a0000413d000000000001004b00000019010000290000000501100270000000000100003f000000010100c03f00000000010004150000001a011000690000000001000002000020400000613d0000157b010000410000001b0200002953ff52ea0000040f000015dd01000041000000400500043d00000000001504350000000401500039000000200200003900000000002104350000002402500039000000800100043d0000000000120435000015f6041001970000001f0310018f001a00000005001d0000004402500039000000a10020008c000022050000413d000000000004004b000020350000613d000000000632001900000080053001bf000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c0000202f0000c13d000000000003004b0000221b0000613d000000a0040000390000000005020019000022110000013d00000019010000290000000501100270000000000100003f00000000010004150000001a011000690000000001000002000015df01000041000000000010043f000015710100004100005401000104300000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000204b0000c13d00001bdc0000013d0000000005420019000000000004004b000020590000613d0000001a06000029000000000702001900000000680604340000000007870436000000000057004b000020550000c13d000000000003004b000020660000613d0000001a044000290000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000000003210019000015a8040000410000000000430435000015010020009c000015010200804100000040022002100000002001100039000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001900000004001d0000001f0040008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001600000004001d00000019050000290000000004540436001300000004001d000000000003004b0000248a0000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001906000029000000000006004b00000000020000190000001305000029000024900000613d000000000101043b00000000020000190000000003250019000000000401041a000000000043043500000001011000390000002002200039000000000062004b0000209f0000413d000024900000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001a0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000020c00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000020bc0000c13d000000000005004b000020cd0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00130000000103550000000100200190000021690000613d000000000200043d000000200030008c000021690000413d0000156201000041000021040000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c70000001a0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000020ef0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000020eb0000c13d000000000005004b000020fc0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00130000000103550000000100200190000021690000613d000000000200043d000000200030008c000021690000413d0000155801000041000000000002004b000021690000613d0000001a0200002953ff52ea0000040f000015690100004100000000001004430000001a0100002900000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000000001004b000000880000613d000000400300043d000015e2010000410000000000130435000000040130003900000020020000390000000000210435000000240130003900000018020000290000000000210435000015f6042001980000001f0520018f001900000003001d00000044023000390000000003420019000000170600002900000014066000390000001206600367000021300000613d000000000706034f0000000008020019000000007907043c0000000008980436000000000038004b0000212c0000c13d000000000005004b0000213d0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000001802200029000000000002043500000000020004140000001a03000029000000040030008c0000215a0000613d0000001b030000290000000b03300039000015f601300197000015e30010009c000015e30100804100000060011002100000001903000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f000015e40110009a0000001a0200002953ff53eb0000040f0000006003100270000115010030019d00130000000103550000000100200190000025c40000613d0000001901000029000015070010009c000014870000213d0000001901000029000000400010043f0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015e5040000410000001a0500002900000dc70000013d000015e601000041000000000010043f000015710100004100005401000104300000001204000367000000000300001900000018060000290000000005630019000000000554034f000000000505043b000000000051041b00000001011000390000002003300039000000000023004b000021700000413d0000001a0020006c000021840000813d0000001a020000290000000302200210000000f80220018f000015f70220027f000015f70220016700000018033000290000001203300367000000000303043b000000000223016f000000000021041b00000001010000390000001a020000290000000102200210000000000112019f0000001b02000029000000000012041b0000000001000019000054000001042e0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c022001970000001a022001af000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015840400004100001c000000013d000000000002004b0000000001000019000024c90000613d0000000301200210000015f70110027f000015f7011001670000000003030433000000000113016f0000000102200210000000000121019f000024c90000013d0000004001500210000015010040009c00001501040080410000006003400210000000000113019f000015010020009c0000150102008041000000c002200210000000000121019f0000001b0200002953ff53eb0000040f000000010220018f00130000000103550000006003100270000115010030019d0000150103300198000021c20000c13d001700600000003d001500800000003d000021eb0000013d0000001f04300039000015b1044001970000003f04400039000015b205400197000000400400043d001700000004001d0000000004450019000000000054004b00000000050000390000000105004039000015070040009c000014870000213d0000000100500190000014870000c13d000000400040043f00000017040000290000000006340436000015f6043001980000001f0530018f001500000006001d0000000003460019000021de0000613d000000000601034f0000001507000029000000006806043c0000000007870436000000000037004b000021da0000c13d000000000005004b000021eb0000613d000000000141034f0000000304500210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f000000000013043500000017010000290000000001010433000000000002004b0000250f0000c13d000000000001004b000025490000c13d000000400300043d001b00000003001d0000156c0100004100000000001304350000000401300039000000200200003900000000002104350000002402300039000000160100002953ff3a680000040f0000001b020000290000000001210049000015010010009c0000150101008041000015010020009c000015010200804100000060011002100000004002200210000000000121019f00005401000104300000000005420019000000000004004b0000220e0000613d000000a006000039000000000702001900000000680604340000000007870436000000000057004b0000220a0000c13d000000000003004b0000221b0000613d000000a0044000390000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000000002210019000000000002043500000000020004140000001b03000029000000040030008c000022260000c13d0000000103000031000000200030008c00000020040000390000000004034019000022570000013d0000001f01100039000015f6011001970000004401100039000015010010009c000015010100804100000060011002100000001a03000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f0000001b0200002953ff53eb0000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001a05700029000022460000613d000000000801034f0000001a09000029000000008a08043c0000000009a90436000000000059004b000022420000c13d000000000006004b000022530000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000025280000613d0000001f01400039000000600210018f0000001a01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001a010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000015de0400004100001c000000013d0000001b0100002953ff3bfa0000040f0000000102000039000000000020043f0000155802000041000000200020043f000300000001001d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b02000029000602400020003d000702200020003d000802000020003d000901e00020003d001401c00020003d001301400020003d001201200020003d001101000020003d001000e00020003d000f00c00020003d000e00a00020003d000d00800020003d000c00600020003d000b00400020003d000a00200020003d0000001502000029000201040020003d001a00000000001d000022a40000013d000000000040043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000005020000290000000002020433000000000101043b000000000101041a0000150403100197000000020030008c000029190000413d0000001a0020006b0000293e0000813d001900000003001d0000001a04000029000000050140021000000004011000290000000001010433001800000001001d000000400200043d00000044012000390000006003000039000000000031043500000020032000390000156f01000041001600000003001d000000000013043500000024032000390000000301000029001700000003001d000000000013043500000012050003670000001b03500360000000000303043b000000840620003900000000003604350000000a03500360000000000303043b000000a40720003900000000003704350000000b03500360000000000303043b000000c40720003900000000003704350000000c03500360000000000303043b000000e40720003900000000003704350000000d03500360000000000303043b000001040720003900000000003704350000000e03500360000000000303043b000001240720003900000000003704350000000f03500360000000000303043b000001440720003900000000003704350000001003500360000000000303043b000001640720003900000000003704350000001103500360000000000303043b000001840720003900000000003704350000001203500360000000000303043b000001a4072000390000000000370435000002440a200039000001c407200039001a00010040003d0000001308500360000000008308043c00000000073704360000000000a7004b000022ec0000c13d0000001403500360000000000b03043b00000000070000310000001b0370006a0000001f0830008a00001556098001970000155603b00197000000000c93013f000000000093004b0000000003000019000015560300404100000000008b004b000000000d000019000015560d0080410000155600c0009c00000000030dc019000000000003004b000000880000c13d0000001b03b00029000000000b35034f000000000b0b043b0000150700b0009c000000880000213d000000200c3000390000000003b7004900000000003c004b000000000d000019000015560d0020410000155603300197000015560ec00197000000000f3e013f00000000003e004b000000000300001900001556030040410000155600f0009c00000000030dc019000000000003004b000000880000c13d000002600100003900000000001a0435000002e4032000390000000000b30435000000000dc5034f000015f60eb001980000030403200039000000000ae30019000023250000613d000000000f0d034f000000000c03001900000000f40f043c000000000c4c04360000000000ac004b000023210000c13d0000001f0cb00190000023320000613d0000000004ed034f000000030cc00210000000000d0a0433000000000dcd01cf000000000dcd022f000000000404043b000001000cc000890000000004c4022f0000000004c401cf0000000004d4019f00000000004a043500000000043b001900000000000404350000000904500360000000000a04043b0000155604a00197000000000c94013f000000000094004b0000000004000019000015560400404100000000008a004b000000000d000019000015560d0080410000155600c0009c00000000040dc019000000000004004b000000880000c13d0000001b0ca000290000000004c5034f000000000a04043b0000150700a0009c000000880000213d000000200dc000390000000004a7004900000000004d004b000000000c000019000015560c0020410000155604400197000015560ed00197000000000f4e013f00000000004e004b000000000400001900001556040040410000155600f0009c00000000040cc019000000000004004b000000880000c13d0000001f04b00039000015f60440019700000000033400190000000004630049000002640b20003900000000004b0435000000000dd5034f000000000ba30436000015f60ea00198000000000ceb0019000023670000613d000000000f0d034f00000000030b001900000000f40f043c00000000034304360000000000c3004b000023630000c13d0000001f03a00190000023740000613d0000000004ed034f0000000303300210000000000d0c0433000000000d3d01cf000000000d3d022f000000000404043b0000010003300089000000000434022f00000000033401cf0000000003d3019f00000000003c04350000000003ba001900000000000304350000000803500360000000000c03043b0000155603c00197000000000493013f000000000093004b0000000003000019000015560300404100000000008c004b000000000d000019000015560d008041000015560040009c00000000030dc019000000000003004b000000880000c13d0000001b03c00029000000000435034f000000000e04043b0000150700e0009c000000880000213d000000200d300039000000050ce002100000000003c7004900000000003d004b000000000400001900001556040020410000155603300197000015560fd0019700000000013f013f00000000003f004b00000000030000190000155603004041000015560010009c000000000304c019000000000003004b000000880000c13d0000001f01a00039000015f6011001970000000001b10019000000000361004900000284042000390000000000340435000000000ae10436000000000bca001900000000000c004b000023a80000613d000000000dd5034f00000000d10d043c000000000a1a04360000000000ba004b000023a40000c13d0000001f00c001900000000701500360000000000a01043b0000155601a00197000000000391013f000000000091004b0000000001000019000015560100404100000000008a004b00000000040000190000155604008041000015560030009c000000000104c019000000000001004b000000880000c13d0000001b03a00029000000000135034f000000000a01043b0000150700a0009c000000880000213d000000200c3000390000000001a7004900000000001c004b0000000003000019000015560300204100001556011001970000155604c00197000000000d14013f000000000014004b000000000100001900001556010040410000155600d0009c000000000103c019000000000001004b000000880000c13d00000000016b0049000002a4032000390000000000130435000000000dc5034f000000000bab0436000015f60ea00198000000000ceb0019000023d90000613d000000000f0d034f00000000030b001900000000f10f043c00000000031304360000000000c3004b000023d50000c13d0000001f03a00190000023e60000613d0000000001ed034f000000030330021000000000040c043300000000043401cf000000000434022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000141019f00000000001c04350000000001ba001900000000000104350000000601500360000000000c01043b0000155601c00197000000000391013f000000000091004b0000000001000019000015560100404100000000008c004b00000000040000190000155604008041000015560030009c000000000104c019000000000001004b000000880000c13d0000001b03c00029000000000135034f000000000801043b000015070080009c000000880000213d00000020093000390000000001870049000000000019004b0000000003000019000015560300204100001556011001970000155604900197000000000714013f000000000014004b00000000010000190000155601004041000015560070009c000000000103c019000000000001004b000000880000c13d0000001f01a00039000015f6011001970000000001b100190000000003610049000002c4042000390000000000340435000000000795034f0000000005810436000015f60980019800000000069500190000241b0000613d000000000a07034f000000000305001900000000a10a043c0000000003130436000000000063004b000024170000c13d0000001f03800190000024280000613d000000000197034f0000000303300210000000000406043300000000043401cf000000000434022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000141019f0000000000160435000000000158001900000000000104350000001f01800039000015f6011001970000000001510019000000170310006a00000064042000390000000000340435000000180300002900000000530304340000000004310436000015f6073001970000001f0630018f000000000045004b000024470000813d000000000007004b000024430000613d00000000016500190000000008640019000000200880008a000000200910008a0000000001780019000000000a790019000000000a0a04330000000000a10435000000200770008c0000243d0000c13d000000000006004b0000245d0000613d0000000008040019000024530000013d0000000008740019000000000007004b000024500000613d0000000009050019000000000a0400190000000091090434000000000a1a043600000000008a004b0000244c0000c13d000000000006004b0000245d0000613d00000000057500190000000301600210000000000608043300000000061601cf000000000616022f00000000050504330000010001100089000000000515022f00000000011501cf000000000161019f00000000001804350000000001430019000000000001043500000000012400490000001f03300039000015f6033001970000000001130019000000200310008a00000000003204350000001f01100039000015f6011001970000000003210019000000000013004b00000000040000390000000104004039000015070030009c000014870000213d0000000100400190000014870000c13d000000400030043f000000000302043300000000020004140000001904000029000000040040008c000022980000613d0000001601000029000015010010009c00001501010080410000004001100210000015010030009c00001501030080410000006003300210000000000113019f000015010020009c0000150102008041000000c002200210000000000121019f000000000204001953ff53eb0000040f00000019040000290000006003100270000115010030019d00130000000103550000000100200190000022980000c13d0000293e0000013d000015f80120019700000013020000290000000000120435000000190000006b000000200200003900000000020060390000003f01200039000015f6021001970000001601200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f00000010020000290000000002020433000015f6042001970000001f0320018f000000110010006b000025520000813d000000000004004b000024ad0000613d00000011063000290000000005310019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000024a70000c13d000000000003004b000025690000613d00000000050100190000255e0000013d00001592030000410000002004000039000000010650008a0000000506600270000015930660009a00000000071400190000000007070433000000000073041b00000020044000390000000103300039000000000063004b000024b60000c13d000000000025004b000024c70000813d0000000305200210000000f80550018f000015f70550027f000015f70550016700000000011400190000000001010433000000000151016f000000000013041b000000010120021000000001011001bf0000159002000041000000000012041b00000014010000290000000001010433001200000001001d000015070010009c000014870000213d0000159401000041000000000101041a000000010010019000000001021002700000007f0220618f001100000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d0000001101000029000000200010008c000024fb0000413d0000159401000041000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000012030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000011010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000024fb0000813d000000000002041b0000000102200039000000000012004b000024f70000413d0000001201000029000000200010008c000025d10000413d0000159401000041000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000200200008a0000001202200180000000000101043b000027be0000c13d0000002003000039000027cb0000013d000000000001004b0000278a0000c13d000015690100004100000000001004430000001b0100002900000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000000001004b000027860000c13d000000400100043d0000004402100039000015ba03000041000000000032043500000024021000390000001d0300003900001a3c0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000252f0000c13d00001bdc0000013d000000000003004b000025de0000c13d000000000006004b000025400000613d00001501037001970002000000320355000000000076001a000038d60000413d0000000006760019000000000565004b000038d60000413d000000000232034f000015010350019700000000023203df000000c0011002100000155c0110019700001568011001c700020000001203b500000000011203af0000000002040019000025f20000013d0000001502000029000015010020009c00001501020080410000004002200210000015010010009c00001501010080410000006001100210000000000121019f00005401000104300000000005410019000000000004004b0000255b0000613d0000001106000029000000000701001900000000680604340000000007870436000000000057004b000025570000c13d000000000003004b000025690000613d001100110040002d0000000303300210000000000405043300000000043401cf000000000434022f000000110600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000003120019000015a8040000410000000000430435000015010010009c000015010100804100000040011002100000002002200039000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b001900000001001d00000016010000290000000001010433001200000001001d000015070010009c000014870000213d0000001901000029000000000101041a000000010010019000000001021002700000007f0220618f001100000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d0000001101000029000000200010008c000025b00000413d0000001901000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000012030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000011010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000025b00000813d000000000002041b0000000102200039000000000012004b000025ac0000413d0000001201000029000000200010008c000029420000413d0000001901000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000200200008a0000001202200180000000000101043b00002a120000c13d000000200300003900002a1f0000013d00001501033001970000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000025cc0000c13d00001bdc0000013d000000120000006b0000000001000019000027d90000613d00000012030000290000000301300210000015f70110027f000015f70110016700000013020000290000000002020433000000000112016f0000000102300210000000000121019f000027d90000013d000000000006004b000025e80000613d00001501087001970002000000820355000000000076001a000038d60000413d0000000006760019000000000565004b000038d60000413d000000000282034f000015010550019700000000025203df000000c0011002100000155c0110019700001567011001c700020000001203b500000000011203af00008009020000390000000005000019000000000600001953ff53f50000040f00130000000103550000006003100270000115010030019d0000000100200190000027260000613d0000000101000039000000000010043f0000156201000041000000200010043f0000000001000414000026120000013d0000001a01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000301043b0000001a02000029000000000002041b000000000003041b0000001b01000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150401100197001b00000001001d000000020010008c0000120a0000413d0000001b01000029000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f000000200500008a0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001072002700000007f0770618f0000001f0070008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001a00000004001d0000000006740436000000000003004b001900000006001d000026660000613d001800000007001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000200500008a0000000100200190000000880000613d0000001807000029000000000007004b0000266c0000613d000000000201043b000000000100001900000019060000290000000003160019000000000402041a000000000043043500000001022000390000002001100039000000000071004b0000265e0000413d0000266d0000013d000015f8012001970000000000160435000000000007004b000000200100003900000000010060390000266d0000013d00000000010000190000003f01100039000000000251016f0000001a01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f0000001a010000290000000001010433000000000001004b0000260d0000613d000015690100004100000000001004430000001b0100002900000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000000001004b000000200900008a000000880000613d000000400b00043d0000156b0100004100000000001b04350000000401b00039000000200200003900000000002104350000002402b000390000001a0100002900000000010104330000000000120435000000000491016f0000001f0310018f0000004402b00039000000190a00002900000000002a004b000026ad0000813d000000000004004b000026a90000613d00000000063a00190000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000026a30000c13d000000000003004b000026c30000613d0000000005020019000026b90000013d0000000005420019000000000004004b000026b60000613d00000000060a0019000000000702001900000000680604340000000007870436000000000057004b000026b20000c13d000000000003004b000026c30000613d000000000a4a00190000000303300210000000000405043300000000043401cf000000000434022f00000000060a04330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000002210019000000000002043500000000020004140000001b03000029000000040030008c000026e10000613d0000001f01100039000000000191016f0000004401100039000015010010009c000015010100804100000060011002100000150100b0009c000015010300004100000000030b40190000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f0000001b02000029001a0000000b001d53ff53eb0000040f0000001a0b0000290000006003100270000115010030019d0013000000010355000000010020019000002fc90000613d0000150700b0009c000014870000213d0000004000b0043f0000001b01000029000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000301043b000000000103041a000000010010019000000001041002700000007f0440618f0000001f0040008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d000000000004004b0000260d0000613d0000001f0040008c0000260c0000a13d001900000004001d001a00000003001d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000201043b00000019010000290000001f01100039000000050110027000000000011200190000000102200039000000000012004b000025fe0000813d000000000002041b0000000102200039000000000012004b000027210000413d000025fe0000013d00001501023001970000001f0420018f0000150303200198000027300000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000036004b0000272c0000c13d000000000004004b0000273d0000613d000000000131034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f000000000013043500000060012002100000540100010430000000400100043d000015860010009c000014870000213d0000004002100039000000400020043f000000010200003900000000012104360000000000010435000000400100043d0000000102100039000015a80300004100000000003204350000000002010433000015cf022001970000000000210435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015d1011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001b00000004001d0000001f0040008c00000000040000390000000104002039000000000043004b000008d40000c13d000000400400043d001900000004001d0000001b050000290000000004540436001a00000004001d000000000003004b00002b030000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b05000029000000000005004b00000000020000190000001a0600002900002b090000613d000000000101043b00000000020000190000000003260019000000000401041a000000000043043500000001011000390000002002200039000000000052004b0000277e0000413d00002b090000013d00000017010000290000000001010433000000000001004b000027ab0000613d000015530010009c000000880000213d000000200010008c000000880000413d00000015010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d000000000001004b000027ab0000c13d000000400100043d0000006402100039000015b80300004100000000003204350000004402100039000015b903000041000000000032043500000024021000390000002a0300003900000000003204350000156c020000410000000000210435000000040210003900000020030000390000000000320435000015010010009c00001501010080410000004001100210000015b6011001c70000540100010430000000400300043d000000240130003900000019020000290000000000210435000015ad010000410000000000130435001700000003001d00000004013000390000001802000029000000000021043500000000010004140000001b02000029000000040020008c0000287a0000c13d0000000103000031000000200030008c00000020040000390000000004034019000028a50000013d000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000140600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b000027c40000c13d000000120020006c000027d60000813d00000012020000290000000302200210000000f80220018f000015f70220027f000015f70220016700000014033000290000000003030433000000000223016f000000000021041b0000001201000029000000010110021000000001011001bf0000159402000041000000000012041b0000159501000041000000000001041b0000159601000041000000000001041b000000400100043d000000140200003900000000022104360000001b0300002900000060033002100000000000320435000015860010009c000014870000213d0000004003100039000000400030043f000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000400300043d00001597020000410000000000230435001400000003001d0000000402300039000000000012043500000000010004140000000002000411000000040020008c0000280b0000c13d0000000103000031000000200030008c00000020040000390000000004034019000028360000013d0000001402000029000015010020009c00001501020080410000004002200210000015010010009c0000150101008041000000c001100210000000000121019f00001598011001c7000000000200041153ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001405700029000028250000613d000000000801034f0000001409000029000000008a08043c0000000009a90436000000000059004b000028210000c13d000000000006004b000028320000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f001300000001035500000001002001900000294f0000613d0000001f01400039000000600210018f0000001401200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d00000014010000290000000001010433000015040010009c000000880000213d0000000002000410000000000012004b00002c620000c13d0000001b010000290000150401100197001400000001001d000000020010008c000017020000413d0000001401000029000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000028760000c13d0000159b01000041000000000201041a0000157c032001970000001404000029000000000343019f000000000031041b000000000040043f0000155401000041000000200010043f001315040020019c0000326a0000c13d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d001300010000003d000032730000013d0000159a01000041000000000010043f000015710100004100005401000104300000001702000029000015010020009c00001501020080410000004002200210000015010010009c0000150101008041000000c001100210000000000121019f000015b3011001c70000001b0200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001705700029000028940000613d000000000801034f0000001709000029000000008a08043c0000000009a90436000000000059004b000028900000c13d000000000006004b000028a10000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f001300000001035500000001002001900000295b0000613d0000001f01400039000000600210018f0000001701200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000004404100039000000240510003900000017020000290000000002020433000000000002004b00002a060000c13d0000002002100039000015af060000410000000000620435000000190600002900000000006504350000001a05000029000000000054043500000044040000390000000000410435000015a30010009c000014870000213d0000008004100039001a00000004001d000000400040043f000015b70010009c000014870000213d000000c004100039000000400040043f00000020040000390000001a050000290000000000450435000000a004100039000015b0050000410000000000540435000000000401043300000000010004140000001b05000029000000040050008c000031f40000c13d000015070030009c000014870000213d00000001020000390000320a0000013d000080090200003900008006040000390000000105000039000000000600001953ff53eb0000040f00130000000103550000006003100270000115010030019d00001501053001970000001f0350003900001502063001970000003f036000390000156107300197000000400300043d0000000004370019000000000074004b00000000070000390000000107004039000015070040009c000014870000213d0000000100700190000014870000c13d000000400040043f0000000004530436000000000006004b000028fb0000613d0000000006640019000000000700003100000012077003670000000008040019000000007907043c0000000008980436000000000068004b000028f70000c13d0000001f0650018f00001503075001980000000005740019000029050000613d000000000801034f0000000009040019000000008a08043c0000000009a90436000000000059004b000029010000c13d000000000006004b000029120000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000000100200190000025f80000c13d000015010040009c000015010400804100000040014002100000000002030433000016930000013d0000001a0020006c0000293e0000c13d00000002010000290000001201100367000000000201043b0000000003000414000000400100043d00000020041000390000155905000041000000000054043500000024041000390000000000240435000000240200003900000000002104350000155a0010009c000014870000213d0000006002100039000000400020043f00000000040104330000155b0040009c00002c660000413d0000156c030000410000000000320435000000a4031000390000156d040000410000000000430435000000840310003900000008040000390000000000430435000000640110003900000020030000390000000000310435000015010020009c000015010200804100000040012002100000156e011001c700005401000104300000157001000041000000000010043f00001571010000410000540100010430000000120000006b000000000100001900002a2d0000613d00000012030000290000000301300210000015f70110027f000015f70110016700000013020000290000000002020433000000000112016f0000000102300210000000000121019f00002a2d0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000029560000c13d00001bdc0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000029620000c13d00001bdc0000013d000000400500043d000000440150003900000060020000390000000000210435000000240150003900000015020000290000000000210435000015eb010000410000000000150435000000040150003900000000000104350000001601000029000000000101043300000064025000390000000000120435000015f6041001970000001f0310018f001b00000005001d0000008402500039000000180020006b0000298c0000813d000000000004004b000029880000613d00000018063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000029820000c13d000000000003004b000029a30000613d0000000005020019000029980000013d0000000005420019000000000004004b000029950000613d0000001806000029000000000702001900000000680604340000000007870436000000000057004b000029910000c13d000000000003004b000029a30000613d001800180040002d0000000303300210000000000405043300000000043401cf000000000434022f000000180600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000002210019000000000002043500000000020004140000001703000029000000040030008c000029ae0000c13d0000000103000031000000200030008c00000020040000390000000004034019000029df0000013d0000001f01100039000015f6011001970000008401100039000015010010009c000015010100804100000060011002100000001b03000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f000000170200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001b05700029000029ce0000613d000000000801034f0000001b09000029000000008a08043c0000000009a90436000000000059004b000029ca0000c13d000000000006004b000029db0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f0013000000010355000000010020019000002c560000613d0000001f01400039000000600210018f0000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001b010000290000000001010433000015040010009c000000880000213d000000000001004b00001dd00000613d0000157900100198000017020000613d000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000015ef02000041000000000101043b000000000101041a000015040010019800001dd00000613d00001dd10000013d0000156c02000041000000000021043500000004021000390000002003000039000000000032043500000036020000390000000000250435000015b40200004100000000002404350000006402100039000015b503000041000027a50000013d000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000160600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b00002a180000c13d000000120020006c00002a2a0000813d00000012020000290000000302200210000000f80220018f000015f70220027f000015f70220016700000016033000290000000003030433000000000223016f000000000021041b0000001201000029000000010110021000000001011001bf0000001902000029000000000012041b0000001b010000290000000001010433000015f6041001970000001f0310018f000000400200043d0000001a0020006b00002a460000813d000000000004004b00002a420000613d0000001a063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c00002a3c0000c13d000000000003004b00002a5d0000613d000000000502001900002a520000013d0000000005420019000000000004004b00002a4f0000613d0000001a06000029000000000702001900000000680604340000000007870436000000000057004b00002a4b0000c13d000000000003004b00002a5d0000613d001a001a0040002d0000000303300210000000000405043300000000043401cf000000000434022f0000001a0600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000003210019000015a8040000410000000000430435000015010020009c000015010200804100000040022002100000002001100039000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b001a00000001001d000000000101041a000000010010019000000001021002700000007f0220618f001b00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d0000001b0000006b00002aac0000613d0000001b010000290000001f0010008c00002aaa0000a13d0000001a01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000201043b0000001b010000290000001f01100039000000050110027000000000011200190000000102200039000000000012004b00002a9b0000813d000000000002041b0000000102200039000000000012004b00002a970000413d0000001a01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000001a02000029000000000002041b001a00000001001d0000001a01000029000000000001041b000000400100043d000000200210003900000017030000290000000000320435000000200200003900000000002104350000004002100039000000180320002900000015040000290000001204400367000000180000006b00002abe0000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b00002aba0000c13d000000140000006b00002ac90000613d000000180440036000000000050304330000000b055001f00000000b05500250000000000404043b0000000c044002500000000c044001f0000000000454019f000000000043043500000017022000290000000000020435000015010010009c000015010100804100000040011002100000000d020000290000004002200039000015010020009c00001501020080410000006002200210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c70000800d020000390000000103000039000015a90400004100000dc70000013d000000400500043d000000440150003900000060020000390000000000210435000000240150003900000015020000290000000000210435000015ec010000410000000000150435000000040150003900000000000104350000001601000029000000000101043300000064025000390000000000120435000015f6041001970000001f0310018f001b00000005001d0000008402500039000000180020006b00002f5e0000813d000000000004004b00002aff0000613d00000018063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c00002af90000c13d000000000003004b00002f750000613d000000000502001900002f6a0000013d000015f8012001970000001a0200002900000000001204350000001b0000006b000000200200003900000000020060390000003f01200039000015f6021001970000001901200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d00000018020000290014002000200092000000400010043f00000019020000290000000032020434001a00000003001d000000020020008c00001dd00000413d000015530020009c000000880000213d000000400020008c000000880000413d00000019030000290000003f033000390000001a02200029000000000023004b0000000004000019000015560400804100001556052001970000155603300197000000000653013f000000000053004b00000000030000190000155603004041000015560060009c000000000304c019000000000003004b000000880000c13d000015860010009c000014870000213d0000004003100039001b00000003001d000000400030043f00000019030000290000006003300039000000000023004b000000880000213d000000410200008a0000001a0020006b00002b430000213d0000001a02000029000000000401001900000000250204340000000004540436000000000032004b00002b3d0000413d000000400200043d001b00000002001d0000001b060000290000004402600039000000a0030000390000000000320435000000240260003900000015030000290000000000320435000015810200004100000000002604350000000402600039000000000002043500000016020000290000000002020433000000a4036000390000000000230435000015f6052001970000001f0420018f000000c403600039000000180030006b00002b670000813d000000000005004b00002b620000613d00000014064000290000000007430019000000200770008a0000000008570019000000000956001900000000090904330000000000980435000000200550008c00002b5c0000c13d000000000004004b00002b7d0000613d0000001805000029000000000603001900002b730000013d0000000006530019000000000005004b00002b700000613d0000001807000029000000000803001900000000790704340000000008980436000000000068004b00002b6c0000c13d000000000004004b00002b7d0000613d00000018055000290000000304400210000000000706043300000000074701cf000000000747022f00000000050504330000010004400089000000000545022f00000000044501cf000000000474019f0000000000460435000000000332001900000000000304350000001b0500002900000064035000390000000041010434000000000013043500000084015000390000000003040433000000000031043500000000010004140000001703000029000000040030008c00002b8f0000c13d0000000103000031000000200030008c0000002004000039000000000403401900002bc00000013d0000001f02200039000015f602200197000000c402200039000015010020009c000015010200804100000060022002100000001b03000029001b00000003001d000015010030009c00001501030080410000004003300210000000000232019f000015010010009c0000150101008041000000c001100210000000000121019f000000170200002953ff53f00000040f00000060031002700000150103300197000000200030008c0000002004000039000000000403401900000020064001900000001b0560002900002baf0000613d000000000701034f0000001b08000029000000007907043c0000000008980436000000000058004b00002bab0000c13d0000001f0740019000002bbc0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000032960000613d0000001f01400039000000600210018f0000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001b020000290000000002020433000000000002004b0000000003000039000000010300c039000000000032004b000000880000c13d000000000002004b000032680000c13d00000019020000290000000002020433000015f6042001970000001f0320018f0000001a0010006b00002bec0000813d000000000004004b00002be80000613d0000001a063000290000000005310019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c00002be20000c13d000000000003004b00002c030000613d000000000501001900002bf80000013d0000000005410019000000000004004b00002bf50000613d0000001a06000029000000000701001900000000680604340000000007870436000000000057004b00002bf10000c13d000000000003004b00002c030000613d001a001a0040002d0000000303300210000000000405043300000000043401cf000000000434022f0000001a0600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000003120019000015a8040000410000000000430435000015010010009c000015010100804100000040011002100000002002200039000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001b00000004001d0000001f0040008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001900000004001d0000001b050000290000000004540436001a00000004001d000000000003004b00002c430000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b0000006b00002c4a0000613d000000000201043b00000000010000190000001b050000290000001a060000290000000003160019000000000402041a000000000043043500000001022000390000002001100039000000000051004b00002c3b0000413d00002c4b0000013d000015f8012001970000001a0200002900000000001204350000001b0000006b0000002001000039000000000100603900002c4b0000013d00000000010000190000003f01100039000015f6021001970000001901200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d000000010020019000002b150000613d000014870000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00002c5d0000c13d00001bdc0000013d0000159901000041000000000010043f00001571010000410000540100010430000000c0023002100000155c0220019700000040011002100000155d0110009a0000155e01100197000000000112019f00000060024002100000155f02200197000000000121019f00001560011001c70000800302000039000000000300001900000000040000190000000005000019000000000600001953ff53eb0000040f00130000000103550000006003100270000115010030019d00001501053001970000001f0350003900001502063001970000003f036000390000156107300197000000400300043d0000000004370019000000000074004b00000000070000390000000107004039000015070040009c000014870000213d0000000100700190000014870000c13d000000400040043f0000000004530436000000000006004b00002c930000613d0000000006640019000000000700003100000012077003670000000008040019000000007907043c0000000008980436000000000068004b00002c8f0000c13d0000001f0650018f0000150307500198000000000574001900002c9d0000613d000000000801034f0000000009040019000000008a08043c0000000009a90436000000000059004b00002c990000c13d000000000006004b00002caa0000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000000100200190000029140000613d0000000101000039000000000010043f0000156201000041000000200010043f000000000100041400002cbc0000013d0000001901000029000000010110021000000001011001bf0000001602000029000000000012041b0000001701000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001202000367000000000101043b000000000101041a0000150401100197001700000001001d000000010010008c000034090000a13d000000400500043d000015630100004100000000001504350000000401500039000000200300003900000000003104350000001b01200360000000000301043b000000240150003900000000003104350000000a03200360000000000303043b000000440450003900000000003404350000000b03200360000000000303043b000000640450003900000000003404350000000c03200360000000000303043b000000840450003900000000003404350000000d03200360000000000303043b000000a40450003900000000003404350000000e03200360000000000303043b000000c40450003900000000003404350000000f03200360000000000303043b000000e40450003900000000003404350000001003200360000000000303043b000001040450003900000000003404350000001103200360000000000303043b000001240450003900000000003404350000001203200360000000000303043b000001440450003900000000003404350000001303200360000001e406500039001900000005001d0000016404500039000000003503043c0000000004540436000000000064004b00002cfd0000c13d0000001403200360000000000703043b00000000030000310000001b0430006a0000001f0440008a00001556054001970000155608700197000000000958013f000000000058004b00000000080000190000155608004041000000000047004b000000000a000019000015560a008041000015560090009c00000000080ac019000000000008004b000000880000c13d0000001b08700029000000000782034f000000000707043b000015070070009c000000880000213d00000020088000390000000009730049000000000098004b000000000a000019000015560a0020410000155609900197000015560b800197000000000c9b013f00000000009b004b000000000900001900001556090040410000155600c0009c00000000090ac019000000000009004b000000880000c13d00000260090000390000000000960435000000190b0000290000028406b000390000000000760435000000000982034f000015f60a700198000002a408b000390000000006a8001900002d370000613d000000000b09034f000000000c08001900000000bd0b043c000000000cdc043600000000006c004b00002d330000c13d0000001f0b70019000002d440000613d0000000009a9034f000000030ab00210000000000b060433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000960435000000000687001900000000000604350000000906200360000000000606043b0000155609600197000000000a59013f000000000059004b00000000090000190000155609004041000000000046004b000000000b000019000015560b0080410000155600a0009c00000000090bc019000000000009004b000000880000c13d0000001b09600029000000000692034f000000000606043b000015070060009c000000880000213d0000002009900039000000000a6300490000000000a9004b000000000b000019000015560b002041000015560aa00197000015560c900197000000000dac013f0000000000ac004b000000000a000019000015560a0040410000155600d0009c000000000a0bc01900000000000a004b000000880000c13d0000001f07700039000015f60770019700000000078700190000000008170049000000190a000029000002040aa0003900000000008a0435000000000992034f0000000007670436000015f60a6001980000000008a7001900002d7a0000613d000000000b09034f000000000c07001900000000bd0b043c000000000cdc043600000000008c004b00002d760000c13d0000001f0b60019000002d870000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000876001900000000000804350000000808200360000000000808043b0000155609800197000000000a59013f000000000059004b00000000090000190000155609004041000000000048004b000000000b000019000015560b0080410000155600a0009c00000000090bc019000000000009004b000000880000c13d0000001b08800029000000000982034f000000000a09043b0000150700a0009c000000880000213d00000020098000390000000508a00210000000000b8300490000000000b9004b000000000c000019000015560c002041000015560bb00197000015560d900197000000000ebd013f0000000000bd004b000000000b000019000015560b0040410000155600e0009c000000000b0cc01900000000000b004b000000880000c13d0000001f06600039000015f60660019700000000067600190000000007160049000000190b000029000002240bb0003900000000007b04350000000006a604360000000007860019000000000008004b00002dbc0000613d000000000992034f000000009a09043c0000000006a60436000000000076004b00002db80000c13d0000001f008001900000000706200360000000000606043b0000155608600197000000000958013f000000000058004b00000000080000190000155608004041000000000046004b000000000a000019000015560a008041000015560090009c00000000080ac019000000000008004b000000880000c13d0000001b08600029000000000682034f000000000606043b000015070060009c000000880000213d00000020088000390000000009630049000000000098004b000000000a000019000015560a0020410000155609900197000015560b800197000000000c9b013f00000000009b004b000000000900001900001556090040410000155600c0009c00000000090ac019000000000009004b000000880000c13d0000000009170049000000190a000029000002440aa0003900000000009a0435000000000982034f0000000007670436000015f60a6001980000000008a7001900002dee0000613d000000000b09034f000000000c07001900000000bd0b043c000000000cdc043600000000008c004b00002dea0000c13d0000001f0b60019000002dfb0000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000876001900000000000804350000000608200360000000000808043b0000155609800197000000000a59013f000000000059004b00000000050000190000155605004041000000000048004b000000000400001900001556040080410000155600a0009c000000000504c019000000000005004b000000880000c13d0000001b05800029000000000452034f000000000404043b000015070040009c000000880000213d00000020055000390000000003430049000000000035004b0000000008000019000015560800204100001556033001970000155609500197000000000a39013f000000000039004b000000000300001900001556030040410000155600a0009c000000000308c019000000000003004b000000880000c13d0000001f03600039000015f60330019700000000067300190000000001160049000000190300002900000264033000390000000000130435000000000352034f0000000001460436000015f605400198000000000251001900002e310000613d000000000603034f0000000007010019000000006806043c0000000007870436000000000027004b00002e2d0000c13d0000001f0640019000002e3e0000613d000000000353034f0000000305600210000000000602043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f00000000003204350000000002140019000000000002043500000000020004140000001703000029000000040030008c00002e470000c13d0000001301000367000000010300003100002e600000013d0000001f03400039000015f603300197000000190400002900000000014100490000000001310019000015010010009c00001501010080410000006001100210000015010040009c000015010300004100000000030440190000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000112019f000000170200002953ff53eb0000040f0000006003100270000115010030019d000015010330019700130000000103550000000100200190000034800000613d000015f604300198000000190240002900002e690000613d000000000501034f0000001906000029000000005705043c0000000006760436000000000026004b00002e650000c13d0000001f0530019000002e760000613d000000000141034f0000000304500210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000015f6011001970000001902100029000000000012004b00000000010000390000000101004039001a00000002001d000015070020009c000014870000213d0000000100100190000014870000c13d0000001a01000029000000400010043f000015530030009c000000880000213d000000200030008c000000880000413d00000019010000290000000001010433000015070010009c000000880000213d000000190330002900000019011000290000001f02100039000000000032004b0000000004000019000015560400804100001556022001970000155605300197000000000652013f000000000052004b00000000020000190000155602004041000015560060009c000000000204c019000000000002004b000000880000c13d0000000021010434000015070010009c000014870000213d0000001f04100039000015f6044001970000003f04400039000015f6044001970000001a04400029000015070040009c000014870000213d000000400040043f0000001a040000290000000004140436001800000004001d0000000004210019000000000034004b000000880000213d000015f6041001970000001f0310018f000000180020006c00002ec00000813d000000000004004b00002ebc0000613d00000000063200190000001805300029000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c00002eb60000c13d000000000003004b00002ed60000613d000000180500002900002ecc0000013d0000001805400029000000000004004b00002ec90000613d0000000006020019000000180700002900000000680604340000000007870436000000000057004b00002ec50000c13d000000000003004b00002ed60000613d00000000024200190000000303300210000000000405043300000000043401cf000000000434022f00000000020204330000010003300089000000000232022f00000000023201cf000000000242019f0000000000250435000000180110002900000000000104350000001701000029000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b001600000001001d0000001a010000290000000001010433001900000001001d000015070010009c000014870000213d0000001601000029000000000101041a000000010010019000000001021002700000007f0220618f000500000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d0000000501000029000000200010008c00002f240000413d0000001601000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000019030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000005010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00002f240000813d000000000002041b0000000102200039000000000012004b00002f200000413d0000001901000029000000200010008c00002f430000413d0000001601000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000200200008a0000001902200180000000000101043b00002f510000613d000000010320008a00000005033002700000000003310019000000010430003900000020030000390000001a053000290000000005050433000000000051041b00000020033000390000000101100039000000000041004b00002f3b0000c13d00002f520000013d000000190000006b00002f4f0000613d00000019030000290000000301300210000015f70110027f000015f70110016700000018020000290000000002020433000000000112016f0000000102300210000000000121019f00002cb50000013d000000000100001900002cb50000013d0000002003000039000000190020006c00002cb20000813d00000019020000290000000302200210000000f80220018f000015f70220027f000015f7022001670000001a033000290000000003030433000000000223016f000000000021041b00002cb20000013d0000000005420019000000000004004b00002f670000613d0000001806000029000000000702001900000000680604340000000007870436000000000057004b00002f630000c13d000000000003004b00002f750000613d001800180040002d0000000303300210000000000405043300000000043401cf000000000434022f000000180600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000002210019000000000002043500000000020004140000001703000029000000040030008c00002f800000c13d0000000103000031000000200030008c0000002004000039000000000403401900002fb10000013d0000001f01100039000015f6011001970000008401100039000015010010009c000015010100804100000060011002100000001b03000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f000000170200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001b0570002900002fa00000613d000000000801034f0000001b09000029000000008a08043c0000000009a90436000000000059004b00002f9c0000c13d000000000006004b00002fad0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000031e80000613d0000001f01400039000000600210018f0000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001b010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d000015ef02000041000000000001004b00001dd00000613d00001dd10000013d00001501033001970000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00002fd10000c13d00001bdc0000013d0000000101000039000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001a02000029000402400020003d000502200020003d000602000020003d000701e00020003d001201c00020003d001101400020003d001001200020003d000f01000020003d000e00e00020003d000d00c00020003d000c00a00020003d000b00800020003d000a00600020003d000900400020003d000800200020003d001900000000001d000030020000013d0000001b01000029000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d00000014020000290000000002020433000000000101043b000000000101041a0000150401100197001b00000001001d000000020010008c000033b20000413d000000190020006b000031e60000813d0000001904000029000000050140021000000013011000290000000001010433001700000001001d000000400200043d00000044012000390000006003000039000000000031043500000020032000390000156f01000041001500000003001d000000000013043500000024032000390000001801000029001600000003001d000000000013043500000012050003670000001a03500360000000000303043b000000840620003900000000003604350000000803500360000000000303043b000000a40720003900000000003704350000000903500360000000000303043b000000c40720003900000000003704350000000a03500360000000000303043b000000e40720003900000000003704350000000b03500360000000000303043b000001040720003900000000003704350000000c03500360000000000303043b000001240720003900000000003704350000000d03500360000000000303043b000001440720003900000000003704350000000e03500360000000000303043b000001640720003900000000003704350000000f03500360000000000303043b000001840720003900000000003704350000001003500360000000000303043b000001a4072000390000000000370435000002440a200039000001c407200039001900010040003d0000001108500360000000008308043c00000000073704360000000000a7004b0000304a0000c13d0000001203500360000000000b03043b00000000070000310000001a0370006a0000001f0830008a00001556098001970000155603b00197000000000c93013f000000000093004b0000000003000019000015560300404100000000008b004b000000000d000019000015560d0080410000155600c0009c00000000030dc019000000000003004b000000880000c13d0000001a03b00029000000000b35034f000000000b0b043b0000150700b0009c000000880000213d000000200c3000390000000003b7004900000000003c004b000000000d000019000015560d0020410000155603300197000015560ec00197000000000f3e013f00000000003e004b000000000300001900001556030040410000155600f0009c00000000030dc019000000000003004b000000880000c13d000002600100003900000000001a0435000002e4032000390000000000b30435000000000dc5034f000015f60eb001980000030403200039000000000ae30019000030830000613d000000000f0d034f000000000c03001900000000f40f043c000000000c4c04360000000000ac004b0000307f0000c13d0000001f0cb00190000030900000613d0000000004ed034f000000030cc00210000000000d0a0433000000000dcd01cf000000000dcd022f000000000404043b000001000cc000890000000004c4022f0000000004c401cf0000000004d4019f00000000004a043500000000043b001900000000000404350000000704500360000000000a04043b0000155604a00197000000000c94013f000000000094004b0000000004000019000015560400404100000000008a004b000000000d000019000015560d0080410000155600c0009c00000000040dc019000000000004004b000000880000c13d0000001a0ca000290000000004c5034f000000000a04043b0000150700a0009c000000880000213d000000200dc000390000000004a7004900000000004d004b000000000c000019000015560c0020410000155604400197000015560ed00197000000000f4e013f00000000004e004b000000000400001900001556040040410000155600f0009c00000000040cc019000000000004004b000000880000c13d0000001f04b00039000015f60440019700000000033400190000000004630049000002640b20003900000000004b0435000000000dd5034f000000000ba30436000015f60ea00198000000000ceb0019000030c50000613d000000000f0d034f00000000030b001900000000f40f043c00000000034304360000000000c3004b000030c10000c13d0000001f03a00190000030d20000613d0000000004ed034f0000000303300210000000000d0c0433000000000d3d01cf000000000d3d022f000000000404043b0000010003300089000000000434022f00000000033401cf0000000003d3019f00000000003c04350000000003ba001900000000000304350000000603500360000000000c03043b0000155603c00197000000000493013f000000000093004b0000000003000019000015560300404100000000008c004b000000000d000019000015560d008041000015560040009c00000000030dc019000000000003004b000000880000c13d0000001a03c00029000000000435034f000000000e04043b0000150700e0009c000000880000213d000000200d300039000000050ce002100000000003c7004900000000003d004b000000000400001900001556040020410000155603300197000015560fd0019700000000013f013f00000000003f004b00000000030000190000155603004041000015560010009c000000000304c019000000000003004b000000880000c13d0000001f01a00039000015f6011001970000000001b10019000000000361004900000284042000390000000000340435000000000ae10436000000000bca001900000000000c004b000031060000613d000000000dd5034f00000000d10d043c000000000a1a04360000000000ba004b000031020000c13d0000001f00c001900000000501500360000000000a01043b0000155601a00197000000000391013f000000000091004b0000000001000019000015560100404100000000008a004b00000000040000190000155604008041000015560030009c000000000104c019000000000001004b000000880000c13d0000001a03a00029000000000135034f000000000a01043b0000150700a0009c000000880000213d000000200c3000390000000001a7004900000000001c004b0000000003000019000015560300204100001556011001970000155604c00197000000000d14013f000000000014004b000000000100001900001556010040410000155600d0009c000000000103c019000000000001004b000000880000c13d00000000016b0049000002a4032000390000000000130435000000000dc5034f000000000bab0436000015f60ea00198000000000ceb0019000031370000613d000000000f0d034f00000000030b001900000000f10f043c00000000031304360000000000c3004b000031330000c13d0000001f03a00190000031440000613d0000000001ed034f000000030330021000000000040c043300000000043401cf000000000434022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000141019f00000000001c04350000000001ba001900000000000104350000000401500360000000000c01043b0000155601c00197000000000391013f000000000091004b0000000001000019000015560100404100000000008c004b00000000040000190000155604008041000015560030009c000000000104c019000000000001004b000000880000c13d0000001a03c00029000000000135034f000000000801043b000015070080009c000000880000213d00000020093000390000000001870049000000000019004b0000000003000019000015560300204100001556011001970000155604900197000000000714013f000000000014004b00000000010000190000155601004041000015560070009c000000000103c019000000000001004b000000880000c13d0000001f01a00039000015f6011001970000000001b100190000000003610049000002c4042000390000000000340435000000000795034f0000000005810436000015f6098001980000000006950019000031790000613d000000000a07034f000000000305001900000000a10a043c0000000003130436000000000063004b000031750000c13d0000001f03800190000031860000613d000000000197034f0000000303300210000000000406043300000000043401cf000000000434022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000141019f0000000000160435000000000158001900000000000104350000001f01800039000015f6011001970000000001510019000000160310006a00000064042000390000000000340435000000170300002900000000530304340000000004310436000015f6073001970000001f0630018f000000000045004b000031a50000813d000000000007004b000031a10000613d00000000016500190000000008640019000000200880008a000000200910008a0000000001780019000000000a790019000000000a0a04330000000000a10435000000200770008c0000319b0000c13d000000000006004b000031bb0000613d0000000008040019000031b10000013d0000000008740019000000000007004b000031ae0000613d0000000009050019000000000a0400190000000091090434000000000a1a043600000000008a004b000031aa0000c13d000000000006004b000031bb0000613d00000000057500190000000301600210000000000608043300000000061601cf000000000616022f00000000050504330000010001100089000000000515022f00000000011501cf000000000161019f00000000001804350000000001430019000000000001043500000000012400490000001f03300039000015f6033001970000000001130019000000200310008a00000000003204350000001f01100039000015f6011001970000000003210019000000000013004b00000000040000390000000104004039000015070030009c000014870000213d0000000100400190000014870000c13d000000400030043f000000000302043300000000020004140000001b01000029000000040010008c00002ff50000613d0000001501000029000015010010009c00001501010080410000004001100210000015010030009c00001501030080410000006003300210000000000113019f000015010020009c0000150102008041000000c002200210000000000121019f0000001b0200002953ff53eb0000040f0000006003100270000115010030019d0013000000010355000000010020019000002ff50000c13d001500000000001d000033b60000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000031ef0000c13d00001bdc0000013d000015010020009c00001501020080410000004002200210000015010040009c00001501040080410000006003400210000000000223019f000015010010009c0000150101008041000000c001100210000000000112019f0000001b0200002953ff53eb0000040f000000010220018f00130000000103550000006001100270000115010010019d00001501031001980000320a0000c13d001900600000003d001800800000003d000032340000013d0000001f01300039000015b1011001970000003f01100039000015b204100197000000400100043d001900000001001d0000000001140019000000000041004b00000000040000390000000104004039000015070010009c000014870000213d0000000100400190000014870000c13d000000400010043f00000019010000290000000005310436000015f6043001980000001f0330018f001800000005001d00000000014500190000001305000367000032270000613d000000000605034f0000001807000029000000006806043c0000000007870436000000000017004b000032230000c13d000000000003004b000032340000613d000000000445034f0000000303300210000000000501043300000000053501cf000000000535022f000000000404043b0000010003300089000000000434022f00000000033401cf000000000353019f000000000031043500000019010000290000000001010433000000000002004b000032440000c13d000000000001004b000032940000c13d000000400300043d001b00000003001d0000156c01000041000000000013043500000004013000390000002002000039000000000021043500000024023000390000001a01000029000021fa0000013d000000000001004b0000325a0000c13d000015690100004100000000001004430000001b0100002900000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000000001004b000025210000613d00000019010000290000000001010433000000000001004b0000120a0000613d000015530010009c000000880000213d000000200010008c000000880000413d00000018010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d000000000001004b0000120a0000c13d000027970000013d000015ef0200004100001dd10000013d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a0000157c0220019700000013022001af000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d0200003900000002030000390000159c04000041000000140500002953ff53eb0000040f0000000100200190000000880000613d000000400200043d0000159d010000410000000000120435001400000002001d00000004012000390000000002000410000000000021043500000000010004140000000002000411000000040020008c000032a20000c13d0000000103000031000000200030008c00000020040000390000000004034019000032cd0000013d00000018020000290000254a0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000329d0000c13d00001bdc0000013d0000001402000029000015010020009c00001501020080410000004002200210000015010010009c0000150101008041000000c001100210000000000121019f00001598011001c7000000000200041153ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001405700029000032bc0000613d000000000801034f0000001409000029000000008a08043c0000000009a90436000000000059004b000032b80000c13d000000000006004b000032c90000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000033fd0000613d0000001f01400039000000600110018f0000001404100029000000000014004b00000000020000390000000102004039001300000004001d000015070040009c000014870000213d0000000100200190000014870000c13d0000001302000029000000400020043f000000200030008c000000880000413d00000014020000290000000002020433001400000002001d000015040020009c000000880000213d0000159e020000410000001304000029000000000024043500000004024000390000001404000029000000000042043500000000020004140000000004000411000000040040008c000033180000613d0000001301000029000015010010009c00001501010080410000004001100210000015010020009c0000150102008041000000c002200210000000000112019f00001598011001c7000000000200041153ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001305700029000033050000613d000000000801034f0000001309000029000000008a08043c0000000009a90436000000000059004b000033010000c13d000000000006004b000033120000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000034d20000613d0000001f01400039000000600110018f0000001301100029000015070010009c000014870000213d000000400010043f000000200030008c000000880000413d00000013010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d000000000001004b0000332b0000c13d00000014020000290000001b0120014f0000150400100198000037350000c13d000000190100002953ff4f390000040f000000180000006b0000357f0000c13d000000160100002900000004061000390000001201000367000000000261034f000000000402043b000015040040009c000000880000213d000000000004004b000038a30000613d0000004002600039000000000321034f000000000303043b000015660030009c00001a360000213d0000002002200039000000000521034f000000000705043b0000000005000031000000160850006a000000230880008a0000155609800197000015560a700197000000000b9a013f00000000009a004b00000000090000190000155609004041000000000087004b000000000800001900001556080080410000155600b0009c000000000908c019000000000009004b000000880000c13d0000000007670019000000000671034f000000000606043b000015070060009c000000880000213d000000000865004900000020077000390000155609800197000015560a700197000000000b9a013f00000000009a004b00000000090000190000155609004041000000000087004b000000000800001900001556080020410000155600b0009c000000000908c019000000000009004b000000880000c13d000000400220008a000000000221034f000000000802043b000000000008004b0000000002000039000000010200c039001b00000008001d000000000028004b000000880000c13d0000000002000414000015010020009c00001a360000213d000080060040008c000037ae0000c13d0000001f04600039000015f6044001970000003f04400039000015f608400197000000400400043d0000000008840019000000000048004b000000000a000039000000010a004039000015070080009c000014870000213d0000000100a00190000014870000c13d000000400080043f0000000008640436000000000a76001900000000005a004b000000880000213d000000000571034f000015f6076001980000001f0960018f00000000017800190000338f0000613d000000000a05034f000000000b08001900000000ac0a043c000000000bcb043600000000001b004b0000338b0000c13d000000000009004b0000339c0000613d000000000575034f0000000307900210000000000901043300000000097901cf000000000979022f000000000505043b0000010007700089000000000575022f00000000057501cf000000000595019f0000000000510435000000000168001900000000000104350000000001040433000015010010009c00001a360000213d000000c0022002100000155c0220019700000040044002100000155d0440009a0000155e04400197000000000242019f00000060011002100000155f01100197000000000112019f00001560011001c7000000000003004b000037c30000c13d0000800602000039000000000300001900000000040000190000000005000019000037c60000013d000000190020006c00000000010000390000000101006039001500000001001d00000001010000290000150401100197001700000001001d000000020010008c0000000001000019000033f30000413d00000001010000290000157900100198000017020000613d0000001701000029000000000010043f0000158201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000348c0000c13d0000001701000029000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150400100198000034de0000c13d0000001701000029000000000010043f0000157b01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000000001000019000035b10000c13d000000000001004b00000000010000390000000101006039000000150000006b0000000002000039000000010200603900000000001201a0000015ed03000041000000000300c0190000185e0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000034040000c13d00001bdc0000013d0000000201000029000000c00110008a000000000312034f000000000403043b000015040040009c000000880000213d000000e001100039000000000312034f000000000303043b000015660030009c00001a360000213d000000a001100039000000000112034f000000000501043b0000000001000031000000150610006a000000230660008a00001556076001970000155608500197000000000978013f000000000078004b00000000070000190000155607004041000000000065004b00000000060000190000155606008041000015560090009c000000000706c019000000000007004b000000880000c13d0000001b06500029000000000562034f000000000505043b000015070050009c000000880000213d0000000008510049000000200760003900001556068001970000155609700197000000000a69013f000000000069004b00000000060000190000155606004041000000000087004b000000000800001900001556080020410000155600a0009c000000000608c019000000000006004b000000880000c13d0000000006000414000015010060009c00001a360000213d000080060040008c000038010000c13d0000001f04500039000015f6044001970000003f04400039000015f608400197000000400400043d0000000008840019000000000048004b00000000090000390000000109004039000015070080009c000014870000213d0000000100900190000014870000c13d000000400080043f00000000085404360000000009750019000000000019004b000000880000213d000000000272034f000015f6075001980000001f0950018f00000000017800190000345d0000613d000000000a02034f000000000b08001900000000ac0a043c000000000bcb043600000000001b004b000034590000c13d000000000009004b0000346a0000613d000000000272034f0000000307900210000000000901043300000000097901cf000000000979022f000000000202043b0000010007700089000000000272022f00000000027201cf000000000292019f0000000000210435000000000158001900000000000104350000000001040433000015010010009c00001a360000213d000000c0026002100000155c0220019700000040044002100000155d0440009a0000155e04400197000000000242019f00000060011002100000155f01100197000000000112019f00001560011001c7000000000003004b000038160000c13d0000800602000039000000000300001900000000040000190000000005000019000038190000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000034870000c13d00001bdc0000013d000000400100043d000015860010009c000014870000213d0000004002100039000000400020043f000000010200003900000000012104360000000000010435000000400100043d0000000102100039000015a80300004100000000003204350000000002010433000015cf022001970000000000210435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015d1011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001b00000004001d0000001f0040008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001900000004001d0000001b050000290000000004540436001a00000004001d000000000003004b000035d70000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b0000006b0000000002000019000035dd0000613d000000000101043b00000000020000190000001a03200029000000000401041a0000000000430435000000010110003900000020022000390000001b0020006c000034ca0000413d000035dd0000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000034d90000c13d00001bdc0000013d000000400500043d000000440150003900000060020000390000000000210435000000240150003900000018020000290000000000210435000015eb0100004100000000001504350000000401500039000000010200003900000000002104350000000301000029000000000101043300000064025000390000000000120435000015f6041001970000001f0310018f001b00000005001d0000008402500039000000020020006b000035040000813d000000000004004b000035000000613d00000002063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000034fa0000c13d000000000003004b0000351b0000613d0000000005020019000035100000013d0000000005420019000000000004004b0000350d0000613d0000000206000029000000000702001900000000680604340000000007870436000000000057004b000035090000c13d000000000003004b0000351b0000613d000200020040002d0000000303300210000000000405043300000000043401cf000000000434022f000000020600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000002210019000000000002043500000000020004140000001703000029000000040030008c000035260000c13d0000000103000031000000200030008c00000020040000390000000004034019000035570000013d0000001f01100039000015f6011001970000008401100039000015010010009c000015010100804100000060011002100000001b03000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f000000170200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001b05700029000035460000613d000000000801034f0000001b09000029000000008a08043c0000000009a90436000000000059004b000035420000c13d000000000006004b000035530000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000037290000613d0000001f01400039000000600210018f0000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001b010000290000000002010433000015040020009c000000880000213d000000000002004b0000000001000019000033f30000613d0000157900200198000017020000613d000000000020043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a00001504001001980000000001000019000000010100c039000033f30000013d001b00000000001d0000001b01000029000000050110021000000017011000290000001202000367000000000112034f000000000301043b00000000010000310000001a0410006a000000430440008a00001556054001970000155606300197000000000756013f000000000056004b00000000050000190000155605004041000000000043004b00000000040000190000155604008041000015560070009c000000000504c019000000000005004b000000880000c13d0000001703300029000000000232034f000000000202043b000015070020009c000000880000213d0000000004210049000000200130003900001556034001970000155605100197000000000635013f000000000035004b00000000030000190000155603004041000000000041004b00000000040000190000155604002041000015560060009c000000000304c019000000000003004b000000880000c13d53ff50c90000040f0000001b020000290000000102200039001b00000002001d000000180020006c000035800000413d0000332f0000013d000000400500043d000000440150003900000060020000390000000000210435000000240150003900000018020000290000000000210435000015ec0100004100000000001504350000000401500039000000010200003900000000002104350000000301000029000000000101043300000064025000390000000000120435000015f6041001970000001f0310018f001b00000005001d0000008402500039000000020020006b000037460000813d000000000004004b000035d30000613d00000002063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000035cd0000c13d000000000003004b0000375d0000613d0000000005020019000037520000013d000015f8012001970000001a0200002900000000001204350000001b0000006b000000200200003900000000020060390000003f01200039000015f6021001970000001901200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d00000002020000290016002000200092000000400010043f00000019020000290000000032020434001a00000003001d000000020020008c000038520000413d000015530020009c000000880000213d000000400020008c000000880000413d00000019030000290000003f033000390000001a02200029000000000023004b0000000004000019000015560400804100001556052001970000155603300197000000000653013f000000000053004b00000000030000190000155603004041000015560060009c000000000304c019000000000003004b000000880000c13d000015860010009c000014870000213d0000004003100039001b00000003001d000000400030043f00000019030000290000006003300039000000000023004b000000880000213d000000410200008a0000001a0020006b000036170000213d0000001a02000029000000000401001900000000250204340000000004540436000000000032004b000036110000413d000000400200043d001b00000002001d0000001b060000290000004402600039000000a00300003900000000003204350000002402600039000000180300002900000000003204350000158102000041000000000026043500000004026000390000000103000039000000000032043500000003020000290000000002020433000000a4036000390000000000230435000015f6052001970000001f0420018f000000c403600039000000020030006b0000363c0000813d000000000005004b000036370000613d00000016064000290000000007430019000000200770008a0000000008570019000000000956001900000000090904330000000000980435000000200550008c000036310000c13d000000000004004b000036520000613d00000002050000290000000006030019000036480000013d0000000006530019000000000005004b000036450000613d0000000207000029000000000803001900000000790704340000000008980436000000000068004b000036410000c13d000000000004004b000036520000613d00000002055000290000000304400210000000000706043300000000074701cf000000000747022f00000000050504330000010004400089000000000545022f00000000044501cf000000000474019f0000000000460435000000000332001900000000000304350000001b0500002900000064035000390000000041010434000000000013043500000084015000390000000003040433000000000031043500000000010004140000001703000029000000040030008c000036640000c13d0000000103000031000000200030008c00000020040000390000000004034019000036950000013d0000001f02200039000015f602200197000000c402200039000015010020009c000015010200804100000060022002100000001b03000029001b00000003001d000015010030009c00001501030080410000004003300210000000000232019f000015010010009c0000150101008041000000c001100210000000000121019f000000170200002953ff53f00000040f00000060031002700000150103300197000000200030008c0000002004000039000000000403401900000020064001900000001b05600029000036840000613d000000000701034f0000001b08000029000000007907043c0000000008980436000000000058004b000036800000c13d0000001f07400190000036910000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000038540000613d0000001f01400039000000600210018f0000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001b020000290000000002020433000000000002004b0000000003000039000000010300c039000000000032004b000000880000c13d000000000002004b000038600000c13d00000019020000290000000002020433000015f6042001970000001f0320018f0000001a0010006b000036c10000813d000000000004004b000036bd0000613d0000001a063000290000000005310019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000036b70000c13d000000000003004b000036d80000613d0000000005010019000036cd0000013d0000000005410019000000000004004b000036ca0000613d0000001a06000029000000000701001900000000680604340000000007870436000000000057004b000036c60000c13d000000000003004b000036d80000613d001a001a0040002d0000000303300210000000000405043300000000043401cf000000000434022f0000001a0600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000003120019000015a8040000410000000000430435000015010010009c000015010100804100000040011002100000002002200039000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001b00000004001d0000001f0040008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001900000004001d0000001b050000290000000004540436001a00000004001d000000000003004b000037160000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001b0000006b0000371d0000613d000000000201043b00000000010000190000001a03100029000000000402041a0000000000430435000000010220003900000020011000390000001b0010006c0000370e0000413d0000371e0000013d000015f8012001970000001a0200002900000000001204350000001b0000006b000000200100003900000000010060390000371e0000013d00000000010000190000003f01100039000015f6021001970000001901200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000035e90000613d000014870000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000037300000c13d00001bdc0000013d000015730100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015010010009c0000150101008041000000c0011002100000159f011001c7000080050200003953ff53f00000040f000000010020019000003a060000613d000000000101043b53ff4f390000040f000038a30000013d0000000005420019000000000004004b0000374f0000613d0000000206000029000000000702001900000000680604340000000007870436000000000057004b0000374b0000c13d000000000003004b0000375d0000613d000200020040002d0000000303300210000000000405043300000000043401cf000000000434022f000000020600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000002210019000000000002043500000000020004140000001703000029000000040030008c000037680000c13d0000000103000031000000200030008c00000020040000390000000004034019000037990000013d0000001f01100039000015f6011001970000008401100039000015010010009c000015010100804100000060011002100000001b03000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f000000170200002953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000001b05700029000037880000613d000000000801034f0000001b09000029000000008a08043c0000000009a90436000000000059004b000037840000c13d000000000006004b000037950000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00130000000103550000000100200190000038620000613d0000001f01400039000000600210018f0000001b01200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f000000200030008c000000880000413d0000001b010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000000880000c13d000033f30000013d000000000003004b0000386e0000c13d000000000006004b000037ba0000613d00001501037001970002000000310355000000000076001a000038d60000413d0000000006760019000000000565004b000038d60000413d000000000131034f000015010350019700000000013103df000000c0022002100000155c0220019700001568022001c700020000002103b500000000012103af0000000002040019000038820000013d000080090200003900008006040000390000000105000039000000000600001953ff53eb0000040f00130000000103550000006003100270000115010030019d00001501053001970000001f0350003900001502063001970000003f036000390000156107300197000000400300043d0000000004370019000000000074004b00000000070000390000000107004039000015070040009c000014870000213d0000000100700190000014870000c13d000000400040043f0000000004530436000000000006004b000037e50000613d0000000006640019000000000700003100000012077003670000000008040019000000007907043c0000000008980436000000000068004b000037e10000c13d0000001f0650018f00001503075001980000000005740019000037ef0000613d000000000801034f0000000009040019000000008a08043c0000000009a90436000000000059004b000037eb0000c13d000000000006004b000037fc0000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000001b0000006b000000010220c1bf0000000100200190000029140000613d000038a30000013d000000000003004b0000000008750019000000c006600210000038b80000c13d000000000005004b0000380e0000613d00001501037001970002000000320355000000000075001a000038d60000413d000000000181004b000038d60000413d000000000232034f000015010110019700000000011203df0000155c0260019700001568022001c700020000002103b500000000012103af0000000002040019000038ca0000013d000080090200003900008006040000390000000105000039000000000600001953ff53eb0000040f00130000000103550000006003100270000115010030019d00001501053001970000001f0350003900001502063001970000003f036000390000156107300197000000400300043d0000000004370019000000000074004b00000000070000390000000107004039000015070040009c000014870000213d0000000100700190000014870000c13d000000400040043f0000000004530436000000000006004b000038380000613d0000000006640019000000000700003100000012077003670000000008040019000000007907043c0000000008980436000000000068004b000038340000c13d0000001f0650018f00001503075001980000000005740019000038420000613d000000000801034f0000000009040019000000008a08043c0000000009a90436000000000059004b0000383e0000c13d000000000006004b0000384f0000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000000100200190000029140000613d000038d00000013d0000000001000019000033f30000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000385b0000c13d00001bdc0000013d0000000101000039000033f30000013d0000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000038690000c13d00001bdc0000013d000000000006004b000038780000613d00001501087001970002000000810355000000000076001a000038d60000413d0000000006760019000000000565004b000038d60000413d000000000181034f000015010550019700000000015103df000000c0022002100000155c0220019700001567022001c700020000002103b500000000012103af00008009020000390000000005000019000000000600001953ff53f50000040f00130000000103550000006003100270000115010030019d0000001b0000006b000038a30000c13d0000000100200190000038a30000c13d00001501023001970000001f0420018f0000150303200198000038940000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000036004b000038900000c13d000000000004004b000038a10000613d000000000131034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f000000000013043500000060012002100000540100010430000000150000006b0000120a0000c13d0000150501000041000000000201041a000015a002200197000000000021041b0000000103000039000000400100043d0000000000310435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001508011001c70000800d02000039000015090400004100000dc70000013d000000000005004b000038c10000613d00001501097001970002000000920355000000000075001a000038d60000413d000000000181004b000038d60000413d000000000292034f000015010110019700000000011203df0000155c0260019700001567022001c700020000002103b500000000012103af00008009020000390000000005000019000000000600001953ff53f50000040f00130000000103550000006003100270000115010030019d000000010020019000003a070000613d0000000101000039000000000010043f0000156201000041000000200010043f0000000001000414000038f20000013d000015d701000041000000000010043f0000001101000039000000040010043f000015980100004100005401000104300000001a01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000001a02000029000000000002041b001a00000001001d0000001a01000029000000000001041b0000001901000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000101041a0000150401100197001900000001001d000000020010008c0000120a0000413d0000001901000029000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b000000000201041a000000010320019000000001042002700000007f0440618f001a00000004001d0000001f0040008c00000000040000390000000104002039000000000442013f0000000100400190000008d40000c13d000000400400043d001800000004001d0000001a050000290000000004540436001b00000004001d000000000003004b000039430000613d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d0000001a0000006b0000394a0000613d000000000201043b00000000010000190000001b03100029000000000402041a0000000000430435000000010220003900000020011000390000001a0010006c0000393b0000413d0000394b0000013d000015f8012001970000001b0200002900000000001204350000001a0000006b000000200100003900000000010060390000394b0000013d00000000010000190000003f01100039000015f6021001970000001801200029000000000021004b00000000020000390000000102004039000015070010009c000014870000213d0000000100200190000014870000c13d000000400010043f00000018010000290000000001010433000000000001004b000038ed0000613d00001569010000410000000000100443000000190100002900000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f000000010020019000003a060000613d000000000101043b000000000001004b000000880000613d000000400500043d0000156b0100004100000000001504350000000401500039000000200200003900000000002104350000002402500039000000180100002900000000010104330000000000120435000015f6041001970000001f0310018f001a00000005001d00000044025000390000001b0020006b0000398a0000813d000000000004004b000039860000613d0000001b063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000039800000c13d000000000003004b000039a10000613d0000000005020019000039960000013d0000000005420019000000000004004b000039930000613d0000001b06000029000000000702001900000000680604340000000007870436000000000057004b0000398f0000c13d000000000003004b000039a10000613d001b001b0040002d0000000303300210000000000405043300000000043401cf000000000434022f0000001b0600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000000002210019000000000002043500000000020004140000001903000029000000040030008c000039bd0000613d0000001f01100039000015f6011001970000004401100039000015010010009c000015010100804100000060011002100000001a03000029000015010030009c00001501030080410000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000121019f000000190200002953ff53eb0000040f0000006003100270000115010030019d0013000000010355000000010020019000003a200000613d0000001a01000029000015070010009c000014870000213d0000001a01000029000000400010043f0000001901000029000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000101043b001a00000001001d000000000101041a000000010010019000000001021002700000007f0220618f001b00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000008d40000c13d0000001b0000006b000038ed0000613d0000001b010000290000001f0010008c000038eb0000a13d0000001a01000029000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000000880000613d000000000201043b0000001b010000290000001f01100039000000050110027000000000011200190000000102200039000000000012004b000038dc0000813d000000000002041b0000000102200039000000000012004b00003a010000413d000038dc0000013d000000000001042f00001501023001970000001f0420018f000015030320019800003a110000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000036004b00003a0d0000c13d000000000004004b00003a1e0000613d000000000131034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000006001200210000054010001043000001501033001970000001f0530018f0000150306300198000000400200043d000000000462001900001bdc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003a280000c13d00001bdc0000013d0000001f03100039000000000023004b0000000004000019000015560400404100001556052001970000155603300197000000000653013f000000000053004b00000000030000190000155603002041000015560060009c000000000304c019000000000003004b00003a440000613d0000001203100367000000000303043b000015070030009c00003a440000213d00000000013100190000002001100039000000000021004b00003a440000213d000000000001042d000000000100001900005401000104300000001f02200039000015f6022001970000000001120019000000000021004b00000000020000390000000102004039000015070010009c00003a520000213d000000010020019000003a520000c13d000000400010043f000000000001042d000015d701000041000000000010043f0000004101000039000000040010043f0000159801000041000054010001043000000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b00003a670000613d000000000400001900000020022000390000000005020433000015040550019700000000015104360000000104400039000000000034004b00003a600000413d000000000001042d00000000430104340000000001320436000015f6063001970000001f0530018f000000000014004b00003a7e0000813d000000000006004b00003a7a0000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c00003a740000c13d000000000005004b00003a940000613d000000000701001900003a8a0000013d0000000007610019000000000006004b00003a870000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b00003a830000c13d000000000005004b00003a940000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000431001900000000000404350000001f03300039000015f6023001970000000001210019000000000001042d0000002003000039000000000331043600000000420204340000000000230435000015f6062001970000001f0520018f0000004001100039000000000014004b00003ab30000813d000000000006004b00003aaf0000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c00003aa90000c13d000000000005004b00003ac90000613d000000000701001900003abf0000013d0000000007610019000000000006004b00003abc0000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b00003ab80000c13d000000000005004b00003ac90000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000412001900000000000404350000001f02200039000015f6022001970000000001120019000000000001042d000000010210019000000001011002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000032004b00003ad80000c13d000000000001042d000015d701000041000000000010043f0000002201000039000000040010043f000015980100004100005401000104300000000002010433000000400100043d000000400310003900000000002304350000002002100039000015c903000041000000000032043500000040030000390000000000310435000015f90010009c00003aff0000813d0000006003100039000000400030043f000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000003b050000613d000000000101043b000000000001042d000015d701000041000000000010043f0000004101000039000000040010043f00001598010000410000540100010430000000000100001900005401000104300003000000000002000300000001001d0000159001000041000000000401041a000000010540019000000001024002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000015004b00003bf30000c13d000000400300043d0000000001230436000000000005004b00003b250000613d0000159004000041000000000040043f000000000002004b00003b2b0000613d000015920500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000024004b00003b1d0000413d00003b2c0000013d000015f8044001970000000000410435000000000002004b0000002004000039000000000400603900003b2c0000013d00000000040000190000003f02400039000000200900008a000000000492016f0000000002340019000000000042004b00000000040000390000000104004039000015070020009c00003bed0000213d000000010040019000003bed0000c13d000000400020043f0000000003030433000000000003004b00003b500000613d000015010030009c00001501030080410000006002300210000015010010009c00001501010080410000004001100210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000003beb0000613d000000400200043d000000000801043b000000200900008a00003b540000013d0000159501000041000000000801041a000000000008004b000015fa080060410000159401000041000000000401041a000000010540019000000001034002700000007f0330618f0000001f0030008c00000000010000390000000101002039000000000114013f000000010010019000003bf30000c13d0000000001320436000000000005004b00003b700000613d0000159404000041000000000040043f000000000003004b00003b760000613d000015cb0500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000034004b00003b680000413d00003b770000013d000015f8044001970000000000410435000000000003004b0000002004000039000000000400603900003b770000013d00000000040000190000003f03400039000000000393016f0000000004230019000000000034004b00000000030000390000000103004039000015070040009c00003bed0000213d000000010030019000003bed0000c13d000000400040043f0000000002020433000000000002004b00003b9b0000613d000200000008001d000015010020009c00001501020080410000006002200210000015010010009c00001501010080410000004001100210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000003beb0000613d000000400400043d000000000101043b000000020800002900003b9f0000013d0000159601000041000000000101041a000000000001004b000015fa01006041000200000004001d00000060024000390000000000120435000000400140003900000000008104350000002002400039000015fb01000041000100000002001d0000000000120435000015cc0100004100000000001004430000000001000414000015010010009c0000150101008041000000c001100210000015cd011001c70000800b0200003953ff53f00000040f000000010020019000003bf90000613d000000000101043b0000000204000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a0010000390000000000140435000015b70040009c00003bed0000213d000000c001400039000000400010043f0000000101000029000015010010009c000015010100804100000040011002100000000002040433000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000003beb0000613d000000000101043b000000400200043d000000220320003900000003040000290000000000430435000015fc03000041000000000032043500000002032000390000000000130435000015010020009c000015010200804100000040012002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015fd011001c7000080100200003953ff53f00000040f000000010020019000003beb0000613d000000000101043b000000000001042d00000000010000190000540100010430000015d701000041000000000010043f0000004101000039000000040010043f00001598010000410000540100010430000015d701000041000000000010043f0000002201000039000000040010043f00001598010000410000540100010430000000000001042f000c000000000002000000120e00036700000000021e034f000000000202043b000000010020008c000c00000001001d00003c520000213d000000000002004b00003e570000613d000000010020008c00004c480000c13d000015cc0100004100000000001004430000000001000414000015010010009c0000150101008041000000c001100210000015cd011001c70000800b0200003953ff53f00000040f000000010020019000004c330000613d000000400300043d000000000201043b000000800020008c000900200030003d00003f360000413d000015660020009c0000000001020019000000800110227000000000040000390000001004002039000015070010009c00000008044021bf0000004001102270000015010010009c00000004044021bf00000020011022700000ffff0010008c00000002044021bf0000001001102270000000ff0010008c00000001044020390000002101400039000015f6011001970000003f06100039000015f6056001970000000005530019000000000035004b00000000060000390000000106004039000015070050009c00004c250000213d000000010060019000004c250000c13d000000400050043f0000000205400039000000000053043500000012080003670000000009000031000000000001004b00003c3f0000613d00000009060000290000000001160019000000000598034f000000005705043c0000000006760436000000000016004b00003c3b0000c13d0000000001030433000000000001004b00004c2d0000613d000000000609001900000009070000290000000001070433000015cf01100197000000f805400210000000000115019f000015fe0110009a00000000001704350000000301400210000000f80110008900000000021201cf000000ff0010008c00000000020020190000002101300039000000000021043500003f470000013d000000020020008c00003e990000613d000000710020008c00004c480000c13d000001c00f1000390000000002fe034f000000000302043b000000000200003100000000041200490000001f0540008a00001556045001970000155606300197000000000746013f000000000046004b00000000040000190000155604004041000000000053004b00000000050000190000155605008041000015560070009c000000000405c019000001200510003900000000055e034f0000010006100039000000e007100039000000c008100039000000a009100039000000800a100039000000600b100039000000400c100039000000200d100039000000000dde034f000000000cce034f000000000bbe034f000000000aae034f00000000099e034f00000000088e034f00000000077e034f00000000066e034f000000000505043b000200000005001d000000000506043b000300000005001d000000000507043b000400000005001d000000000508043b000500000005001d000000000509043b000600000005001d00000000050a043b000700000005001d00000000050b043b000800000005001d00000000050c043b000900000005001d00000000050d043b000a00000005001d000000000004004b00004c2b0000c13d000000000313001900000000043e034f000000000404043b000015070040009c00004c2b0000213d0000000006420049000000200530003900001556036001970000155607500197000000000837013f000000000037004b00000000030000190000155603004041000000000065004b00000000060000190000155606002041000015560080009c000000000306c019000000000003004b00004c2b0000c13d0000000003000414000000000004004b00003cac0000613d000015010650019700020000006e0355000000000054001a00004c420000413d0000000004540019000000000242004b00004c420000413d000000000e6e034f000b0000000f001d000015010220019700020000002e03e50000155b0030009c00004c340000813d00000000012e03df000000c0023002100000155c0220019700001568022001c700020000002103b500000000012103af000080100200003953ff53fa0000040f0000006003100270000115010030019d00001501043001970013000000010355000000010020019000004c590000613d0000001f0240003900001502072001970000003f027000390000156102200197000000400600043d0000000002260019000000000062004b00000000030000390000000103004039000015070020009c00004c250000213d000000010030019000004c250000c13d000000400020043f000000000546043600000012020003670000000003000031000000000007004b00003cd90000613d0000000007750019000000000832034f0000000009050019000000008a08043c0000000009a90436000000000079004b00003cd50000c13d0000001f0740018f000015030840019800000000048500190000000b0c00002900003ce40000613d000000000901034f000000000a050019000000009b09043c000000000aba043600000000004a004b00003ce00000c13d000000000007004b0000000c0900002900003cf20000613d000000000181034f0000000307700210000000000804043300000000087801cf000000000878022f000000000101043b0000010007700089000000000171022f00000000017101cf000000000181019f00000000001404350000000001060433000000200010008c00004c3b0000c13d0000000004930049000000400ac000390000000001a2034f000000000101043b0000001f0440008a00001556064001970000155607100197000000000867013f000000000067004b00000000060000190000155606004041000000000041004b00000000040000190000155604008041000015560080009c000000000604c019000000000006004b00004c2b0000c13d0000000004050433000100000004001d0000000004910019000000000142034f000000000101043b000015070010009c00004c2b0000213d00000005011002100000000003130049000000200640003900001556043001970000155605600197000000000745013f000000000045004b00000000040000190000155604004041000000000036004b00000000030000190000155603002041000015560070009c000000000403c019000000000004004b00004c2b0000c13d0000001f0510018f000000400300043d0000002004300039000000000001004b00003d2a0000613d000000000262034f00000000061400190000000007040019000000002802043c0000000007870436000000000067004b00003d260000c13d000b0000000a001d000000000005004b00000000001304350000003f0110003900001557011001970000000001130019000000000031004b00000000020000390000000102004039000015070010009c00004c250000213d000000010020019000004c250000c13d000000400010043f000015010040009c000015010400804100000040014002100000000002030433000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f00000001002001900000000c090000290000000b0200002900004c2b0000613d00000020032000390000001202000367000000000332034f000000000403043b000000000300003100000000059300490000001f0550008a00001556065001970000155607400197000000000867013f000000000067004b00000000060000190000155606004041000000000054004b00000000050000190000155605008041000015560080009c000000000605c019000000000a01043b000000000006004b00004c2b0000c13d0000000001940019000000000412034f000000000404043b000015070040009c00004c2b0000213d0000000006430049000000200510003900001556016001970000155607500197000000000817013f000000000017004b00000000010000190000155601004041000000000065004b00000000060000190000155606002041000015560080009c000000000106c019000000000001004b00004c2b0000c13d0000000001000414000000000004004b00003d800000613d00001501065001970002000000620355000000000054001a00004c420000413d0000000004540019000000000343004b00004c420000413d000000000262034f000c0000000a001d000015010330019700020000003203e5000015010010009c00004c340000213d00000000023203df000000c0011002100000155c0110019700001568011001c700020000001203b500000000011203af000080100200003953ff53fa0000040f0000006003100270000115010030019d00001501033001970013000000010355000000010020019000004c710000613d0000001f0230003900001502052001970000003f025000390000156104200197000000400200043d0000000004420019000000000024004b00000000060000390000000106004039000015070040009c00004c250000213d000000010060019000004c250000c13d000000400040043f0000000004320436000000000005004b00003dac0000613d0000000005540019000000000600003100000012066003670000000007040019000000006806043c0000000007870436000000000057004b00003da80000c13d0000001f0530018f000015030630019800000000036400190000000c0a00002900003db70000613d000000000701034f0000000008040019000000007907043c0000000008980436000000000038004b00003db30000c13d000000000005004b00003dc40000613d000000000161034f0000000305500210000000000603043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001304350000000001020433000000200010008c00004c3b0000c13d0000000002040433000000400100043d000001c0031000390000000000230435000001a0021000390000000000a20435000001800210003900000001030000290000000000320435000001600210003900000002030000290000000000320435000001400210003900000003030000290000000000320435000001200210003900000004030000290000000000320435000001000210003900000005030000290000000000320435000000e00210003900000006030000290000000000320435000000c00210003900000007030000290000000000320435000000a0021000390000000803000029000000000032043500000080021000390000000903000029000000000032043500000060021000390000000a030000290000000000320435000000400210003900000071030000390000000000320435000000200210003900001606030000410000000000320435000001c0030000390000000000310435000016070010009c00004c250000213d000001e003100039000000400030043f000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000004c2b0000613d000000000101043b000b00000001001d000000400100043d000c00000001001d000015cc0100004100000000001004430000000001000414000015010010009c0000150101008041000000c001100210000015cd011001c70000800b0200003953ff53f00000040f000000010020019000004c330000613d0000000c040000290000002002400039000000000101043b000016080300004100000000003204350000008003400039000000000013043500000060014000390000160903000041000000000031043500000040014000390000160a030000410000000000310435000000800100003900000000001404350000160b0040009c00004c250000213d000000a001400039000000400010043f000015010020009c000015010200804100000040012002100000000002040433000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000004c2b0000613d000000000301043b000000400100043d00000042021000390000000b0400002900000000004204350000002002100039000015fc0400004100000000004204350000002204100039000000000034043500000042030000390000000000310435000015a30010009c00004c250000213d0000008003100039000000400030043f000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f000000000200041400004c1a0000013d000000400d00043d000001000310003900000000023e034f000000000402043b000000800040008c000a002000d0003d00003ee60000413d000015660040009c0000000002040019000000800220227000000000050000390000001005002039000015070020009c00000008055021bf0000004002202270000015010020009c00000004055021bf00000020022022700000ffff0020008c00000002055021bf0000001002202270000000ff0020008c00000001055020390000002106500039000015f6066001970000003f07600039000015f60270019700000000022d00190000000000d2004b00000000070000390000000107004039000015070020009c00004c250000213d000000010070019000004c250000c13d000000400020043f000000020250003900000000002d04350000000002000031000000000006004b00003e870000613d0000000a08000029000000000668001900000000072e034f000000007907043c0000000008980436000000000068004b00003e830000c13d00000000060d0433000000000006004b00004c2d0000613d0000000a010000290000000006010433000015cf06600197000000f807500210000000000667019f000015fe0660009a00000000006104350000000305500210000000f80550008900000000045401cf000000ff0050008c00000000040020190000002105d00039000000000045043500003ef60000013d000015cc0100004100000000001004430000000001000414000015010010009c0000150101008041000000c001100210000015cd011001c70000800b0200003953ff53f00000040f000000010020019000004c330000613d000000400600043d000000000101043b000000800010008c000000200f600039000000200b00008a00003f8b0000413d000015660010009c0000000002010019000000800220227000000000030000390000001003002039000015070020009c00000008033021bf0000004002202270000015010020009c00000004033021bf00000020022022700000ffff0020008c00000002033021bf0000001002202270000000ff0020008c000000010330203900000021023000390000000002b2016f0000003f042000390000000004b4016f0000000004460019000000000064004b00000000050000390000000105004039000015070040009c00004c250000213d000000010050019000004c250000c13d000000400040043f0000000204300039000000000046043500000012080003670000000009000031000000000002004b00003ed40000613d00000000022f0019000000000498034f00000000050f0019000000004704043c0000000005750436000000000025004b00003ed00000c13d0000000002060433000000000002004b00004c2d0000613d000000000509001900000000020f0433000015cf02200197000000f804300210000000000224019f000015fe0220009a00000000002f04350000000302300210000000f80220008900000000012101cf000000ff0020008c00000000010020190000002102600039000000000012043500003f9b0000013d0000158600d0009c00004c250000213d0000004002d00039000000400020043f000000010200003900000000002d0435000000f805400210000000000004004b0000155605006041000000000200003100000000042e034f000000000404043b000015cf04400197000000000454019f0000000a010000290000000000410435000000400400043d000000600530008a00000000035e034f000000000603043b000000800060008c000000200340003900003fe00000413d000015660060009c0000000008060019000000800880227000000000070000390000001007002039000015070080009c00000008077021bf0000004008802270000015010080009c00000004077021bf00000020088022700000ffff0080008c00000002077021bf0000001008802270000000ff0080008c00000001077020390000002108700039000015f6088001970000003f0a800039000015f609a001970000000009940019000000000049004b000000000a000039000000010a004039000015070090009c00004c250000213d0000000100a0019000004c250000c13d000000400090043f00000002097000390000000000940435000000000008004b00003f250000613d00000000092e034f0000000008830019000000000a030019000000009b09043c000000000aba043600000000008a004b00003f210000c13d0000000008040433000000000008004b00004c2d0000613d0000000008030433000015cf08800197000000f809700210000000000889019f000015fe0880009a00000000008304350000000307700210000000f80770008900000000067601cf000000ff0070008c00000000060020190000002107400039000000000067043500003fee0000013d000015860030009c00004c250000213d0000004001300039000000400010043f00000001010000390000000000130435000000f801200210000000000002004b000015560100604100000000060000310000001208000367000000000268034f000000000202043b000015cf02200197000000000112019f00000009020000290000000000120435000000400b00043d0000000c010000290000010002100039000000000128034f000000000401043b000000800040008c0008002000b0003d000500000006001d000a0000006803530000402d0000413d000015660040009c0000000001040019000000800110227000000000050000390000001005002039000015070010009c00000008055021bf0000004001102270000015010010009c00000004055021bf00000020011022700000ffff0010008c00000002055021bf0000001001102270000000ff0010008c00000001055020390000002101500039000015f6011001970000003f07100039000015f60670019700000000066b00190000000000b6004b00000000070000390000000107004039000015070060009c00004c250000213d000000010070019000004c250000c13d000000400060043f000000020650003900000000006b0435000000000001004b00003f790000613d000000050680036000000008070000290000000001170019000000006906043c0000000007970436000000000017004b00003f750000c13d00000000010b0433000000000001004b00004c2d0000613d00000008070000290000000001070433000015cf01100197000000f806500210000000000116019f000015fe0110009a00000000001704350000000301500210000000f80110008900000000041401cf000000ff0010008c00000000040020190000002101b0003900000000004104350000403c0000013d000015860060009c00004c250000213d0000004002600039000000400020043f00000001020000390000000000260435000000f802100210000000000001004b000015560200604100000000050000310000001208000367000000000158034f000000000101043b000015cf01100197000000000121019f00000000001f0435000000400c00043d0000000c010000290000010001100039000000000218034f000000000302043b000000800030008c000000200dc00039000b000000080353000500000005001d000a0000005803530000407c0000413d000015660030009c0000000002030019000000800220227000000000040000390000001004002039000015070020009c00000008044021bf0000004002202270000015010020009c00000004044021bf00000020022022700000ffff0020008c00000002044021bf0000001002202270000000ff0020008c000000010440203900000021024000390000000002b2016f0000003f052000390000000005b5016f00000000055c00190000000000c5004b00000000070000390000000107004039000015070050009c00004c250000213d000000010070019000004c250000c13d000000400050043f000000020540003900000000005c0435000000000002004b00003fcf0000613d00000005070000290000000b0570035f00000000022d001900000000070d0019000000005805043c0000000007870436000000000027004b00003fcb0000c13d00000000020c0433000000000002004b00004c2d0000613d00000000020d0433000015cf02200197000000f805400210000000000225019f000015fe0220009a00000000002d04350000000302400210000000f80220008900000000032301cf000000ff0020008c00000000030020190000002102c0003900000000003204350000408a0000013d000015860040009c00004c250000213d0000004007400039000000400070043f00000001070000390000000000740435000000f807600210000000000006004b000015560700604100000000062e034f000000000606043b000015cf06600197000000000676019f0000000000630435000000400550008a00000000055e034f000000400600043d000000000705043b000000800070008c000040cc0000413d000015660070009c0000000005070019000000800550227000000000080000390000001008002039000015070050009c00000008088021bf0000004005502270000015010050009c00000004088021bf00000020055022700000ffff0050008c00000002088021bf0000001005502270000000ff0050008c00000001088020390000002109800039000015f6099001970000003f0a900039000015f605a001970000000005560019000000000065004b000000000a000039000000010a004039000015070050009c00004c250000213d0000000100a0019000004c250000c13d000000400050043f00000002058000390000000005560436000000000009004b0000401c0000613d000000000a2e034f0000000009950019000000000b05001900000000ac0a043c000000000bcb043600000000009b004b000040180000c13d0000000009060433000000000009004b00004c2d0000613d0000000009050433000015cf09900197000000f80a80021000000000099a019f000015fe0990009a00000000009504350000000308800210000000f80880008900000000078701cf000000ff0080008c000000000700201900000021086000390000000000780435000040da0000013d0000158600b0009c00004c250000213d0000004001b00039000000400010043f000000010100003900000000001b0435000000f801400210000000000004004b00001556010060410000000a0400035f000000000404043b000015cf04400197000000000114019f00000008040000290000000000140435000000400f00043d000000600420008a000000000148034f000000000201043b000000800020008c0000002009f00039000040f20000413d000015660020009c0000000001020019000000800110227000000000050000390000001005002039000015070010009c00000008055021bf0000004001102270000015010010009c00000004055021bf00000020011022700000ffff0010008c00000002055021bf0000001001102270000000ff0010008c00000001055020390000002101500039000015f6011001970000003f07100039000015f60670019700000000066f00190000000000f6004b00000000070000390000000107004039000015070060009c00004c250000213d000000010070019000004c250000c13d000000400060043f000000020650003900000000006f0435000000000001004b0000406b0000613d000000050680036000000000011900190000000007090019000000006a06043c0000000007a70436000000000017004b000040670000c13d00000000010f0433000000000001004b00004c2d0000613d0000000001090433000015cf01100197000000f806500210000000000116019f000015fe0110009a00000000001904350000000301500210000000f80110008900000000021201cf000000ff0010008c00000000020020190000002101f000390000000000210435000041000000013d0000158600c0009c00004c250000213d0000004002c00039000000400020043f000000010200003900000000002c0435000000f802300210000000000003004b00001556020060410000000a0300035f000000000303043b000015cf03300197000000000223019f00000000002d0435000000400e00043d000000400110008a0000000b0210035f000000000302043b000000800030008c0008002000e0003d000041400000413d000015660030009c0000000002030019000000800220227000000000040000390000001004002039000015070020009c00000008044021bf0000004002202270000015010020009c00000004044021bf00000020022022700000ffff0020008c00000002044021bf0000001002202270000000ff0020008c000000010440203900000021024000390000000002b2016f0000003f052000390000000005b5016f00000000055e00190000000000e5004b00000000070000390000000107004039000015070050009c00004c250000213d000000010070019000004c250000c13d000000400050043f000000020540003900000000005e0435000000000002004b000040ba0000613d00000005070000290000000b0570035f00000008070000290000000002270019000000005805043c0000000007870436000000000027004b000040b60000c13d00000000020e0433000000000002004b00004c2d0000613d00000008070000290000000002070433000015cf02200197000000f805400210000000000225019f000015fe0220009a00000000002704350000000302400210000000f80220008900000000032301cf000000ff0020008c00000000030020190000002102e0003900000000003204350000414f0000013d000015860060009c00004c250000213d0000004005600039000000400050043f00000001050000390000000005560436000000f808700210000000000007004b000015560800604100000000072e034f000000000707043b000015cf07700197000000000787019f00000000007504350000000004040433000015f6084001970000001f0740018f000000400100043d000800000001001d0000002001100039000000000013004b000041900000813d000000000008004b000040ee0000613d000000000a7300190000000009710019000000200990008a000000200aa0008a000000000b890019000000000c8a0019000000000c0c04330000000000cb0435000000200880008c000040e80000c13d000000000007004b000041a60000613d00000000090100190000419c0000013d0000158600f0009c00004c250000213d0000004001f00039000000400010043f000000010100003900000000001f0435000000f801200210000000000002004b00001556010060410000000a0200035f000000000202043b000015cf02200197000000000112019f0000000000190435000000400200043d000000400540008a000000000158034f000000000401043b000000800040008c000000200a2000390000423a0000413d000015660040009c0000000001040019000000800110227000000000060000390000001006002039000015070010009c00000008066021bf0000004001102270000015010010009c00000004066021bf00000020011022700000ffff0010008c00000002066021bf0000001001102270000000ff0010008c00000001066020390000002101600039000015f6011001970000003f0c100039000015f607c001970000000007720019000000000027004b000000000c000039000000010c004039000015070070009c00004c250000213d0000000100c0019000004c250000c13d000000400070043f00000002076000390000000000720435000000000001004b0000412f0000613d000000050c80036000000000011a001900000000070a001900000000cd0c043c0000000007d70436000000000017004b0000412b0000c13d0000000001020433000000000001004b00004c2d0000613d00000000010a0433000015cf01100197000000f807600210000000000117019f000015fe0110009a00000000001a04350000000301600210000000f80110008900000000041401cf000000ff0010008c000000000400201900000021012000390000000000410435000042480000013d0000158600e0009c00004c250000213d0000004002e00039000000400020043f000000010200003900000000002e0435000000f802300210000000000003004b00001556020060410000000a0300035f000000000303043b000015cf03300197000000000223019f00000008030000290000000000230435000000400500043d000000200310008a0000000b0130035f000000000101043b000000800010008c000700200050003d000042990000413d000015660010009c0000000002010019000000800220227000000000040000390000001004002039000015070020009c00000008044021bf0000004002202270000015010020009c00000004044021bf00000020022022700000ffff0020008c00000002044021bf0000001002202270000000ff0020008c000000010440203900000021024000390000000002b2016f0000003f072000390000000007b7016f0000000007750019000000000057004b00000000080000390000000108004039000015070070009c00004c250000213d000000010080019000004c250000c13d000000400070043f00000002074000390000000000750435000000000002004b0000417f0000613d00000005080000290000000b0780035f00000007080000290000000002280019000000007907043c0000000008980436000000000028004b0000417b0000c13d0000000002050433000000000002004b00004c2d0000613d00000007080000290000000002080433000015cf02200197000000f807400210000000000227019f000015fe0220009a00000000002804350000000302400210000000f80220008900000000012101cf000000ff0020008c00000000010020190000002102500039000042a70000013d0000000009810019000000000008004b000041990000613d000000000a030019000000000b01001900000000ac0a0434000000000bcb043600000000009b004b000041950000c13d000000000007004b000041a60000613d00000000038300190000000307700210000000000809043300000000087801cf000000000878022f00000000030304330000010007700089000000000373022f00000000037301cf000000000383019f0000000000390435000700000001001d000000000314001900000000000304350000000004060433000015f6074001970000001f0640018f000000000035004b000041be0000813d000000000007004b000041ba0000613d00000000096500190000000008630019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c000041b40000c13d000000000006004b0000000008030019000041ca0000c13d000041d40000013d0000000008730019000000000007004b000041c70000613d0000000009050019000000000a030019000000009b090434000000000aba043600000000008a004b000041c30000c13d000000000006004b000041d40000613d00000000057500190000000306600210000000000708043300000000076701cf000000000767022f00000000050504330000010006600089000000000565022f00000000056501cf000000000575019f00000000005804350000000003340019000000000003043500000008050000290000000003530049000000200430008a00000000004504350000001f03300039000015f6033001970000000001530019000000000031004b00000000030000390000000103004039000b00000001001d000015070010009c00004c250000213d000000010030019000004c250000c13d0000000b01000029000000400010043f000015860010009c00004c250000213d0000000c01000029000000400310003900000000033e034f000000000303043b0000000b060000290000004004600039000000400040043f0000002005600039000015ff04000041000600000005001d000000000045043500000015040000390000000000460435000000600330021000000021046000390000000000340435000001200310003900000000043e034f000000400f00043d000000000404043b000000800040008c0009002000f0003d000042ea0000413d000015660040009c0000000006040019000000800660227000000000050000390000001005002039000015070060009c00000008055021bf0000004006602270000015010060009c00000004055021bf00000020066022700000ffff0060008c00000002055021bf0000001006602270000000ff0060008c00000001055020390000002106500039000015f6066001970000003f07600039000015f60770019700000000077f00190000000000f7004b00000000080000390000000108004039000015070070009c00004c250000213d000000010080019000004c250000c13d000000400070043f000000020750003900000000007f0435000000000006004b000042280000613d00000000072e034f00000009080000290000000006680019000000007907043c0000000008980436000000000068004b000042240000c13d00000000060f0433000000000006004b00004c2d0000613d00000009010000290000000006010433000015cf06600197000000f807500210000000000667019f000015fe0660009a00000000006104350000000305500210000000f80550008900000000045401cf000000ff0050008c00000000040020190000002105f000390000000000450435000042f90000013d000015860020009c00004c250000213d0000004001200039000000400010043f00000001010000390000000000120435000000f801400210000000000004004b00001556010060410000000a0400035f000000000404043b000015cf04400197000000000114019f00000000001a0435000000400400043d000015860040009c00004c250000213d000000200150008a000000000118034f000000000101043b0000004006400039000000400060043f0000002007400039000015ff06000041000400000007001d000000000067043500000015060000390000000000640435000000600110021000000021064000390000000000160435000000c001500039000000000118034f000000400e00043d000000000501043b000000800050008c0007000000080353000043950000413d000015660050009c0000000001050019000000800110227000000000060000390000001006002039000015070010009c00000008066021bf0000004001102270000015010010009c00000004066021bf00000020011022700000ffff0010008c00000002066021bf0000001001102270000000ff0010008c00000001066020390000002101600039000015f6011001970000003f0c100039000015f607c0019700000000077e00190000000000e7004b000000000c000039000000010c004039000015070070009c00004c250000213d0000000100c0019000004c250000c13d000000400070043f0000000207600039000000000d7e0436000000000001004b000042880000613d00000000011d00190000000a0700035f000000000c0d0019000000007807043c000000000c8c043600000000001c004b000042840000c13d00000000010e0433000000000001004b00004c2d0000613d00000000010d0433000015cf01100197000000f807600210000000000117019f000015fe0110009a00000000001d04350000000301600210000000f80110008900000000051501cf000000ff0010008c00000000050020190000002101e000390000000000510435000043a30000013d000015860050009c00004c250000213d0000004002500039000000400020043f00000001020000390000000000250435000000f802100210000000000001004b00001556020060410000000a0100035f000000000101043b000015cf01100197000000000121019f00000007020000290000000000120435000000400100043d000000400430008a0000000b0240035f000000000302043b000000800030008c000600200010003d000043300000413d000015660030009c0000000002030019000000800220227000000000070000390000001007002039000015070020009c00000008077021bf0000004002202270000015010020009c00000004077021bf00000020022022700000ffff0020008c00000002077021bf0000001002202270000000ff0020008c000000010770203900000021027000390000000002b2016f0000003f082000390000000008b8016f0000000008810019000000000018004b00000000090000390000000109004039000015070080009c00004c250000213d000000010090019000004c250000c13d000000400080043f00000002087000390000000000810435000000000002004b000042d80000613d00000005090000290000000b0890035f00000006090000290000000002290019000000008a08043c0000000009a90436000000000029004b000042d40000c13d0000000002010433000000000002004b00004c2d0000613d00000006090000290000000002090433000015cf02200197000000f808700210000000000228019f000015fe0220009a00000000002904350000000302700210000000f80220008900000000032301cf000000ff0020008c0000000003002019000000210210003900000000003204350000433f0000013d0000158600f0009c00004c250000213d0000004005f00039000000400050043f000000010500003900000000005f0435000000f805400210000000000004004b000015560500604100000000042e034f000000000404043b000015cf04400197000000000454019f00000009010000290000000000410435000000a00330003900000000043e034f000000000504043b0000000c0100002900000000041200490000001f0640008a00001556046001970000155607500197000000000847013f000000000047004b00000000040000190000155604004041000000000065004b00000000070000190000155607008041000015560080009c000000000407c019000000000004004b00004c2b0000c13d000000000715001900000000047e034f000000000404043b000015070040009c00004c2b0000213d000000000842004900000020077000390000155609800197000015560a700197000000000b9a013f00000000009a004b00000000090000190000155609004041000000000087004b000000000800001900001556080020410000155600b0009c000000000908c019000000000009004b00004c2b0000c13d000000010040008c0000452f0000c13d00000000047e034f000000000404043b000015560040009c000047080000413d000000400100043d000015860010009c00004c250000213d000000000a0100190000004004100039000000400040043f000000010400003900000000014104360000160104000041000047180000013d000015860010009c00004c250000213d0000004002100039000000400020043f00000001020000390000000000210435000000f802300210000000000003004b00001556020060410000000a0300035f000000000303043b000015cf03300197000000000223019f00000006030000290000000000230435000000400800043d000015860080009c00004c250000213d000000200240008a0000000b0220035f000000000202043b0000004003800039000000400030043f0000002009800039000015ff03000041000200000009001d000000000039043500000015030000390000000000380435000000600220021000000021038000390000000000230435000000c0024000390000000b0220035f000000400400043d000000000702043b000000800070008c000043be0000413d000015660070009c0000000002070019000000800220227000000000030000390000001003002039000015070020009c00000008033021bf0000004002202270000015010020009c00000004033021bf00000020022022700000ffff0020008c00000002033021bf0000001002202270000000ff0020008c000000010330203900000021023000390000000002b2016f0000003f092000390000000009b9016f0000000009940019000000000049004b000000000a000039000000010a004039000015070090009c00004c250000213d0000000100a0019000004c250000c13d000000000a0d0019000000000d0f0019000000400090043f00000002093000390000000009940436000300000009001d000000000002004b000043810000613d000000030f00002900000000022f00190000000a0900035f000000009b09043c000000000fbf043600000000002f004b0000437d0000c13d0000000002040433000000000002004b000000200b00008a00004c2d0000613d000000000f0d0019000000030d00002900000000020d0433000015cf02200197000000f809300210000000000229019f000015fe0220009a00000000002d04350000000302300210000000f80220008900000000032701cf000000ff0020008c000000000300201900000021024000390000000000320435000043ce0000013d0000158600e0009c00004c250000213d0000004001e00039000000400010043f0000000101000039000000000d1e0436000000f801500210000000000005004b00001556010060410000000a0500035f000000000505043b000015cf05500197000000000115019f00000000001d04350000000003030433000015f6053001970000001f0130018f000000400600043d000600000006001d0000002006600039000000090060006b000b00000006001d000043ea0000813d000000000005004b000043b80000613d00000009071000290000000b06100029000000200660008a000000200770008a0000000008560019000000000c570019000000000c0c04330000000000c80435000000200550008c000043b20000c13d000000000001004b0000000b08000029000044010000613d00000000060800190000000907000029000043f70000013d000015860040009c00004c250000213d000000000a0d00190000004002400039000000400020043f00000001020000390000000009240436000000f802700210000000000007004b00001556020060410000000a0300035f000000000303043b000015cf03300197000000000223019f000300000009001d000000000029043500000000060604330000000007b6016f0000001f0360018f000000400200043d000400000002001d0000002002200039000000000d0f001900000000002f004b000900000002001d000045510000813d000000000007004b000043e40000613d00000000093d00190000000902300029000000200220008a000000200990008a000000000b720019000000000f790019000000000f0f04330000000000fb0435000000200770008c000043de0000c13d000000000003004b000000200b00008a000000090f000029000045690000613d00000000020f00190000455f0000013d0000000006560019000000000005004b000043f30000613d00000009070000290000000b0c0000290000000078070434000000000c8c043600000000006c004b000043ef0000c13d000000000001004b0000000b08000029000044010000613d00000009075000290000000301100210000000000506043300000000051501cf000000000515022f00000000070704330000010001100089000000000717022f00000000011701cf000000000151019f00000000001604350000000003830019000000000003043500000000070b0433000015f6057001970000001f0170018f000000080030006b000044190000813d000000000005004b000044140000613d00000008081000290000000006130019000000200660008a000000200b80008a0000000008560019000000000c5b0019000000000c0c04330000000000c80435000000200550008c0000440e0000c13d000000000001004b0000442f0000613d00000000060300190000000808000029000044250000013d0000000006530019000000000005004b000044220000613d000000080b000029000000000c03001900000000b80b0434000000000c8c043600000000006c004b0000441e0000c13d000000000001004b0000442f0000613d00000008085000290000000301100210000000000506043300000000051501cf000000000515022f00000000080804330000010001100089000000000818022f00000000011801cf000000000151019f00000000001604350000000003370019000000000003043500000000070f0433000015f6057001970000001f0170018f000000000039004b000044460000813d000000000005004b000044420000613d00000000081900190000000006130019000000200660008a000000200880008a000000000b560019000000000c580019000000000c0c04330000000000cb0435000000200550008c0000443c0000c13d000000000001004b0000445c0000613d0000000006030019000044520000013d0000000006530019000000000005004b0000444f0000613d0000000008090019000000000b030019000000008c080434000000000bcb043600000000006b004b0000444b0000c13d000000000001004b0000445c0000613d00000000095900190000000301100210000000000506043300000000051501cf000000000515022f00000000080904330000010001100089000000000818022f00000000011801cf000000000151019f0000000000160435000000000337001900000000000304350000000002020433000015f6052001970000001f0120018f00000000003a004b000044740000813d000000000005004b0000446f0000613d00000000071a00190000000006130019000000200660008a000000200770008a0000000008560019000000000957001900000000090904330000000000980435000000200550008c000044690000c13d000000000001004b00000006090000290000448b0000613d0000000006030019000044810000013d0000000006530019000000000005004b0000447d0000613d00000000070a0019000000000803001900000000790704340000000008980436000000000068004b000044790000c13d000000000001004b00000006090000290000448b0000613d000000000a5a00190000000301100210000000000506043300000000051501cf000000000515022f00000000070a04330000010001100089000000000717022f00000000011701cf000000000151019f0000000000160435000000000232001900000000000204350000000003040433000015f6043001970000001f0130018f000000040a00002900000000002a004b000044a30000813d000000000004004b0000449f0000613d00000000061a00190000000005120019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000044990000c13d000000000001004b000044b90000613d0000000005020019000044af0000013d0000000005420019000000000004004b000044ac0000613d00000000060a0019000000000702001900000000680604340000000007870436000000000057004b000044a80000c13d000000000001004b000044b90000613d000000000a4a00190000000301100210000000000405043300000000041401cf000000000414022f00000000060a04330000010001100089000000000616022f00000000011601cf000000000141019f00000000001504350000000002230019000000000002043500000000030e0433000015f6043001970000001f0130018f00000000002d004b000044d00000813d000000000004004b000044cc0000613d00000000061d00190000000005120019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c000044c60000c13d000000000001004b0000000005020019000044dc0000c13d000044e60000013d0000000005420019000000000004004b000044d90000613d00000000060d0019000000000702001900000000680604340000000007870436000000000057004b000044d50000c13d000000000001004b000044e60000613d000000000d4d00190000000301100210000000000405043300000000041401cf000000000414022f00000000060d04330000010001100089000000000616022f00000000011601cf000000000141019f0000000000150435000000000123001900000000000104350000000001910049000000200210008a00000000002904350000001f01100039000015f601100197000000000a91001900000000001a004b000000000100003900000001010040390000150700a0009c000000070700035f00004c250000213d000000010010019000004c250000c13d0000004000a0043f0000000c0600002900000005080000290000000002680049000001c001600039000000000117034f000000000101043b0000001f0220008a00001556032001970000155604100197000000000534013f000000000034004b00000000030000190000155603002041000000000021004b00000000020000190000155602004041000015560050009c000000000302c019000000000003004b00004c2b0000613d0000000001610019000000000217034f000000000202043b000015070020009c00004c2b0000213d0000000003280049000000200810003900001556013001970000155604800197000000000514013f000000000014004b00000000010000190000155601004041000000000038004b00000000030000190000155603002041000015560050009c000000000103c019000000000001004b00004c2b0000c13d000000010020008c000046c90000c13d000000000187034f000000000101043b000015560010009c000049a20000413d0000158600a0009c00004c250000213d0000004001a00039000000400010043f000000010100003900000000031a04360000160101000041000c00000003001d0000000000130435000049b30000013d000000400100043d000000380040008c0000470b0000413d000015860010009c00004c250000213d000000000a0100190000004007100039000000400070043f000015010040009c00000000070400190000002007702270000000000800003900000004080020390000ffff0070008c00000002088021bf0000001007702270000000ff0070008c00000001088021bf00000000072e034f00000002098000390000000001910436000000000707043b000015cf07700197000000f809800210000000000779019f00001600077001c7000500000001001d00000000007104350000000307800210000000f80770015f00000000047401cf0000002107a0003900000000004704350000471a0000013d0000000002720019000000000007004b0000455a0000613d00000000090d0019000000090f000029000000009b090434000000000fbf043600000000002f004b000045560000c13d000000000003004b000000200b00008a000000090f000029000045690000613d000000000d7d00190000000303300210000000000702043300000000073701cf000000000737022f00000000090d04330000010003300089000000000939022f00000000033901cf000000000373019f00000000003204350000000006f600190000000000060435000000000c0c04330000000007bc016f0000001f03c0018f00000000006a004b000045810000813d000000000007004b0000457c0000613d00000000093a00190000000002360019000000200220008a000000200990008a000000000b720019000000000f790019000000000f0f04330000000000fb0435000000200770008c000045760000c13d000000000003004b000000200f00008a000045980000613d00000000020600190000458e0000013d0000000002760019000000000007004b0000458a0000613d00000000090a0019000000000f060019000000009b090434000000000fbf043600000000002f004b000045860000c13d000000000003004b000000200f00008a000045980000613d000000000a7a00190000000303300210000000000702043300000000073701cf000000000737022f00000000090a04330000010003300089000000000939022f00000000033901cf000000000373019f000000000032043500000000066c0019000000000006043500000000090e04330000000007f9016f0000001f0390018f000000080a00002900000000006a004b000045b00000813d000000000007004b000045ac0000613d000000000b3a00190000000002360019000000200220008a000000200cb0008a000000000b720019000000000e7c0019000000000e0e04330000000000eb0435000000200770008c000045a60000c13d000000000003004b000045c60000613d0000000002060019000045bc0000013d0000000002760019000000000007004b000045b90000613d000000000c0a0019000000000e06001900000000cb0c0434000000000ebe043600000000002e004b000045b50000c13d000000000003004b000045c60000613d000000000a7a00190000000303300210000000000702043300000000073701cf000000000737022f000000000b0a04330000010003300089000000000b3b022f00000000033b01cf000000000373019f00000000003204350000000006690019000000000006043500000000050504330000000007f5016f0000001f0350018f000000070a00002900000000006a004b000045df0000813d000000000007004b000045da0000613d00000000093a00190000000002360019000000200220008a000000200990008a000000000b720019000000000c790019000000000c0c04330000000000cb0435000000200770008c000045d40000c13d000000000003004b000000040c000029000045f60000613d0000000002060019000045ec0000013d0000000002760019000000000007004b000045e80000613d00000000090a0019000000000c060019000000009b090434000000000cbc043600000000002c004b000045e40000c13d000000000003004b000000040c000029000045f60000613d000000000a7a00190000000303300210000000000702043300000000073701cf000000000737022f00000000090a04330000010003300089000000000939022f00000000033901cf000000000373019f00000000003204350000000005650019000000000005043500000000010104330000000006f1016f0000001f0310018f000000060a00002900000000005a004b0000460f0000813d000000000006004b0000460a0000613d00000000073a00190000000002350019000000200220008a000000200770008a0000000009620019000000000b670019000000000b0b04330000000000b90435000000200660008c000046040000c13d000000000003004b000000020b000029000046260000613d00000000020500190000461c0000013d0000000002650019000000000006004b000046180000613d00000000070a00190000000009050019000000007b0704340000000009b90436000000000029004b000046140000c13d000000000003004b000000020b000029000046260000613d000000000a6a00190000000303300210000000000602043300000000063601cf000000000636022f00000000070a04330000010003300089000000000737022f00000000033701cf000000000363019f00000000003204350000000001510019000000000001043500000000050804330000000006f5016f0000001f0350018f00000000001b004b0000463e0000813d000000000006004b000000030a0000290000463a0000613d00000000073b00190000000002310019000000200220008a000000200770008a0000000008620019000000000967001900000000090904330000000000980435000000200660008c000046340000c13d000000000003004b000046550000613d00000000020100190000464b0000013d0000000002610019000000000006004b000000030a000029000046480000613d00000000070b0019000000000801001900000000790704340000000008980436000000000028004b000046440000c13d000000000003004b000046550000613d000000000b6b00190000000303300210000000000602043300000000063601cf000000000636022f00000000070b04330000010003300089000000000737022f00000000033701cf000000000363019f00000000003204350000000001150019000000000001043500000000030404330000000005f3016f0000001f0430018f00000000001a004b0000466c0000813d000000000005004b000046680000613d00000000064a00190000000002410019000000200220008a000000200660008a0000000007520019000000000856001900000000080804330000000000870435000000200550008c000046620000c13d000000000004004b0000000002010019000046780000c13d000046820000013d0000000002510019000000000005004b000046750000613d00000000060a0019000000000701001900000000680604340000000007870436000000000027004b000046710000c13d000000000004004b000046820000613d000000000a5a00190000000304400210000000000502043300000000054501cf000000000545022f00000000060a04330000010004400089000000000646022f00000000044601cf000000000454019f0000000000420435000000000113001900000000000104350000000001c10049000000200210008a00000000002c04350000001f011000390000000001f1016f0000000009c10019000000000019004b00000000010000390000000101004039000015070090009c00004c250000213d000000010010019000004c250000c13d000000400090043f0000000c0600002900000005080000290000000002680049000001c0016000390000000b0700035f000000000117034f000000000101043b0000001f0220008a00001556032001970000155604100197000000000534013f000000000034004b00000000030000190000155603004041000000000021004b00000000020000190000155602008041000015560050009c000000000302c019000000000003004b00004c2b0000c13d0000000002610019000000000127034f000000000101043b000015070010009c00004c2b0000213d0000000003180049000000200820003900001556023001970000155604800197000000000524013f000000000024004b00000000020000190000155602004041000000000038004b00000000030000190000155603002041000015560050009c000000000203c019000000000002004b00004c2b0000c13d000000010010008c000046e90000c13d000000000287034f000000000202043b000015560020009c00004adf0000413d000015860090009c00004c250000213d0000004002900039000000400020043f0000000102000039000000000b290436000016010200004100004aee0000013d000000380020008c000049a50000413d0000158600a0009c00004c250000213d0000004001a00039000000400010043f000015010020009c00000000010200190000002001102270000000000300003900000004030020390000ffff0010008c00000002033021bf0000001001102270000000ff0010008c00000001033021bf000000020130003900000000051a04360000000a0100035f000000000101043b000015cf01100197000000f804300210000000000114019f00001600011001c7000c00000005001d00000000001504350000000301300210000000f80110015f00000000011201cf0000002103a000390000000000130435000049b30000013d000000380010008c00004ae20000413d000015860090009c00004c250000213d0000004002900039000000400020043f000015010010009c00000000020100190000002002202270000000000300003900000004030020390000ffff0020008c00000002033021bf0000001002202270000000ff0020008c00000001033021bf0000000202300039000000000b2904360000000a0200035f000000000202043b000015cf02200197000000f804300210000000000224019f00001600022001c700000000002b04350000000302300210000000f80220015f00000000022101cf0000002103900039000000000023043500004aef0000013d000000600a000039000500800000003d0000471a0000013d000015860010009c00004c250000213d000000000a0100190000004007100039000000400070043f0000000107000039000000000171043600000000072e034f000000000707043b000015cf07700197000000f804400210000000000447019f00001556044001c7000500000001001d000000000041043500040000000a001d000000800330008a00000000033e034f000000000303043b000000000003004b00030000000d001d00020000000f001d0000476e0000613d000015cc0100004100000000001004430000000001000414000015010010009c0000150101008041000000c001100210000015cd011001c70000800b0200003953ff53f00000040f000000010020019000004c330000613d000000400300043d000000000401043b000000800040008c000000030d000029000000020f000029000047720000413d000015660040009c0000000001040019000000800110227000000000070000390000001007002039000015070010009c00000008077021bf0000004001102270000015010010009c00000004077021bf00000020011022700000ffff0010008c00000002077021bf0000001001102270000000ff0010008c00000001077020390000002101700039000015f6061001970000003f01600039000015f6011001970000000001130019000000000031004b00000000020000390000000102004039000015070010009c00004c250000213d000000010020019000004c250000c13d000000400010043f00000002017000390000000005130436000000120e0003670000000002000031000000000006004b0000475d0000613d000000000665001900000000082e034f0000000009050019000000008a08043c0000000009a90436000000000069004b000047590000c13d0000000006030433000000000006004b00004c2d0000613d0000000008050433000015cf08800197000000f809700210000000000889019f000015fe0880009a00000000008504350000000307700210000000f80770008900000000047401cf000000ff0070008c000000000400201900000021033000390000000000430435000047820000013d000000600400003900000080030000390000000c01000029000047c50000013d000015860030009c00004c250000213d0000004001300039000000400010043f000000f807400210000000000004004b0000155607006041000000010600003900000000056304360000000002000031000000120e00036700000000032e034f000000000303043b000015cf03300197000000000373019f0000000000350435000015f6086001970000001f0760018f000000400400043d0000002003400039000000000035004b000047980000813d000000000008004b000047940000613d000000000a7500190000000009730019000000200990008a000000200aa0008a000000000b890019000000000c8a0019000000000c0c04330000000000cb0435000000200880008c0000478e0000c13d000000000007004b0000000009030019000047a40000c13d000047ae0000013d0000000009830019000000000008004b000047a10000613d000000000a050019000000000b03001900000000ac0a0434000000000bcb043600000000009b004b0000479d0000c13d000000000007004b000047ae0000613d00000000058500190000000307700210000000000809043300000000087801cf000000000878022f00000000050504330000010007700089000000000575022f00000000057501cf000000000585019f000000000059043500000000056300190000160c06000041000000000065043500000000054500490000001e0650008a00000000006404350000002105500039000015f6065001970000000005460019000000000065004b00000000060000390000000106004039000015070050009c00004c250000213d000000010060019000004c250000c13d0000000c01000029000001c006100039000000400050043f00000000056e034f00000000061200490000001f0660008a000000000505043b000000000065004b0000000007000019000015560700804100001556066001970000155608500197000000000968013f000000000068004b00000000060000190000155606004041000015560090009c000000000607c019000000000006004b00004c2b0000c13d00000000080d0433000000080600002900000000090604330000000b06000029000000000a060433000000000b0f04330000000406000029000000000c060433000000000515001900000000065e034f000000000606043b000015070060009c00004c2b0000213d000000000d62004900000020075000390000155605d0019700000000010e034f000015560e700197000000000f5e013f00000000005e004b000000000500001900001556050040410000000000d7004b000000000d000019000015560d0020410000155600f0009c00000000050dc019000000000005004b00004c2b0000c13d000000000e01034f00000000058900190000000005a500190000000005b500190000000005c50019000000000565001900000000080404330000000005850019000000400a00043d0000150705500197000000380050008c000048180000413d0000158600a0009c00004c250000213d0000004008a00039000000400080043f000015010050009c00000000080500190000002008802270000000000b000039000000040b0020390000ffff0080008c000000020bb021bf0000001008802270000000ff0080008c000000010bb021bf00000000022e034f0000000208b0003900000000098a0436000000000202043b000015cf02200197000000f80cb0021000000000022c019f00001604022001c700000000002904350000000302b00210000000f80220015f00000000022501cf0000002105a000390000000000250435000048250000013d0000158600a0009c00004c250000213d0000004008a00039000000400080043f00000000022e034f000000010800003900000000098a0436000000000202043b000015cf02200197000000f805500210000000000225019f000016030220009a0000000000290435000015f60b8001970000001f0a80018f000000400200043d0000002005200039000000000059004b0000483b0000813d00000000000b004b000048370000613d000000000da90019000000000ca50019000000200cc0008a000000200dd0008a000000000ebc0019000000000fbd0019000000000f0f04330000000000fe0435000000200bb0008c000048310000c13d00000000000a004b000000000c050019000048470000c13d000048510000013d000000000cb5001900000000000b004b000048440000613d000000000d090019000000000e05001900000000df0d0434000000000efe04360000000000ce004b000048400000c13d00000000000a004b000048510000613d0000000009b90019000000030aa00210000000000b0c0433000000000bab01cf000000000bab022f0000000009090433000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f00000000009c04350000000008850019000000000008043500000003090000290000000009090433000015f60b9001970000001f0a90018f0000000a0080006b0000486a0000813d00000000000b004b000048650000613d0000000a0da00029000000000ca80019000000200cc0008a000000200dd0008a000000000ebc0019000000000fbd0019000000000f0f04330000000000fe0435000000200bb0008c0000485f0000c13d00000000000a004b000048800000613d000000000c0800190000000a0d000029000048760000013d000000000cb8001900000000000b004b000048730000613d0000000a0d000029000000000e08001900000000df0d0434000000000efe04360000000000ce004b0000486f0000c13d00000000000a004b000048800000613d0000000a0db00029000000030aa00210000000000b0c0433000000000bab01cf000000000bab022f000000000d0d0433000001000aa00089000000000dad022f000000000aad01cf000000000aba019f0000000000ac04350000000008890019000000000008043500000008090000290000000009090433000015f60b9001970000001f0a90018f000000070080006b000048990000813d00000000000b004b000048940000613d000000070da00029000000000ca80019000000200cc0008a000000200dd0008a000000000ebc0019000000000fbd0019000000000f0f04330000000000fe0435000000200bb0008c0000488e0000c13d00000000000a004b000048af0000613d000000000c080019000000070d000029000048a50000013d000000000cb8001900000000000b004b000048a20000613d000000070d000029000000000e08001900000000df0d0434000000000efe04360000000000ce004b0000489e0000c13d00000000000a004b000048af0000613d000000070db00029000000030aa00210000000000b0c0433000000000bab01cf000000000bab022f000000000d0d0433000001000aa00089000000000dad022f000000000aad01cf000000000aba019f0000000000ac0435000000000889001900000000000804350000000b090000290000000009090433000015f60b9001970000001f0a90018f000000060080006b000048ca0000813d00000000000b004b000048c30000613d000000060da00029000000000ca80019000000200cc0008a000000200dd0008a000000000ebc0019000000000fbd0019000000000f0f04330000000000fe0435000000200bb0008c000048bd0000c13d00000000000a004b000000090e000029000000020f000029000048e20000613d000000000c080019000000060d000029000048d80000013d000000000cb8001900000000000b004b000048d30000613d000000060d000029000000000e08001900000000df0d0434000000000efe04360000000000ce004b000048cf0000c13d00000000000a004b000000090e000029000000020f000029000048e20000613d000000060db00029000000030aa00210000000000b0c0433000000000bab01cf000000000bab022f000000000d0d0433000001000aa00089000000000dad022f000000000aad01cf000000000aba019f0000000000ac04350000000008890019000000000008043500000000090f0433000015f60b9001970000001f0a90018f00000000008e004b000048fb0000813d00000000000b004b000048f50000613d000000090da00029000000000ca80019000000200cc0008a000000200dd0008a000000000ebc0019000000000fbd0019000000000f0f04330000000000fe0435000000200bb0008c000048ef0000c13d00000000000a004b000000050e000029000049120000613d000000000c080019000000090d000029000049080000013d000000000cb8001900000000000b004b000049040000613d000000090d000029000000000e08001900000000df0d0434000000000efe04360000000000ce004b000049000000c13d00000000000a004b000000050e000029000049120000613d000000090db00029000000030aa00210000000000b0c0433000000000bab01cf000000000bab022f000000000d0d0433000001000aa00089000000000dad022f000000000aad01cf000000000aba019f0000000000ac04350000000008890019000000000008043500000004090000290000000009090433000015f60b9001970000001f0a90018f00000000008e004b0000492b0000813d00000000000b004b000049260000613d000000050da00029000000000ca80019000000200cc0008a000000200dd0008a000000000ebc0019000000000fbd0019000000000f0f04330000000000fe0435000000200bb0008c000049200000c13d00000000000a004b000049410000613d000000000c080019000000050d000029000049370000013d000000000cb8001900000000000b004b000049340000613d000000050d000029000000000e08001900000000df0d0434000000000efe04360000000000ce004b000049300000c13d00000000000a004b000049410000613d000000050db00029000000030aa00210000000000b0c0433000000000bab01cf000000000bab022f000000000d0d0433000001000aa00089000000000dad022f000000000aad01cf000000000aba019f0000000000ac0435000000000a71034f0000000001890019000015f6086001980000001f0960018f000000000001043500000000078100190000494e0000613d000000000b0a034f000000000c01001900000000bd0b043c000000000cdc043600000000007c004b0000494a0000c13d000000000009004b0000495b0000613d00000000088a034f0000000309900210000000000a070433000000000a9a01cf000000000a9a022f000000000808043b0000010009900089000000000898022f00000000089801cf0000000008a8019f0000000000870435000000000161001900000000000104350000000004040433000015f6074001970000001f0640018f000000000013004b000049720000813d000000000007004b0000496e0000613d00000000096300190000000008610019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c000049680000c13d000000000006004b000049880000613d00000000080100190000497e0000013d0000000008710019000000000007004b0000497b0000613d0000000009030019000000000a010019000000009b090434000000000aba043600000000008a004b000049770000c13d000000000006004b000049880000613d00000000037300190000000306600210000000000708043300000000076701cf000000000767022f00000000030304330000010006600089000000000363022f00000000036301cf000000000373019f0000000000380435000000000114001900000000000104350000000001210049000000200310008a00000000003204350000001f01100039000015f6031001970000000001230019000000000031004b00000000030000390000000103004039000015070010009c00004c250000213d000000010030019000004c250000c13d000000400010043f000015010050009c000015010500804100000040015002100000000002020433000015010020009c00001501020080410000006002200210000000000112019f000000000200041400004c1a0000013d000000600a000039000c00800000003d000049b30000013d0000158600a0009c00004c250000213d0000004001a00039000000400010043f000000010100003900000000041a04360000000a0100035f000000000101043b000015cf01100197000000f803200210000000000131019f00001556011001c7000c00000004001d0000000000140435000000400b00043d0000158600b0009c00004c250000213d0000004001b00039000000400010043f0000000106000039000000000c6b04360000000a0100035f000000000101043b000015cf0310019700001602013001c700000000001c04350000000001090433000000000112001900000000040a04330000000004410019000000400100043d00000001044000390000150705400197000000380050008c000900000008001d000049e40000413d000015860010009c00004c250000213d000015010050009c00000000040500190000002004402270000000000600003900000004060020390000ffff0040008c00000002066021bf00000010044022700000004008100039000000400080043f000000ff0040008c00000001066021bf000000f804600210000000000334019f00001604033001c7000000200d10003900000000003d04350000000303600210000000f80330015f00000000033501cf0000002104100039000000000034043500000002036000390000000000310435000049ed0000013d000015860010009c00004c250000213d0000004004100039000000400040043f000000000d610436000000f804500210000000000334019f000016030330009a00000000003d0435000000400800043d0000002009800039000015600300004100000000003904350000000003010433000015f6053001970000001f0130018f000000210480003900000000004d004b00004a070000813d000000000005004b00004a030000613d000000000e1d00190000000006140019000000200660008a000000200fe0008a000000000e56001900000000075f0019000000000707043300000000007e0435000000200550008c000049fd0000c13d000000000001004b000000000604001900004a130000c13d00004a1d0000013d0000000006540019000000000005004b00004a100000613d000000000f0d0019000000000e04001900000000f70f0434000000000e7e043600000000006e004b00004a0c0000c13d000000000001004b00004a1d0000613d000000000d5d00190000000301100210000000000506043300000000051501cf000000000515022f00000000070d04330000010001100089000000000717022f00000000011701cf000000000151019f00000000001604350000000003430019000000000003043500000006010000290000000006010433000015f6056001970000001f0160018f0000000b0030006b00004a380000813d000000000005004b00004a310000613d0000000b041000290000000007130019000000200d70008a000000200e40008a00000000045d001900000000075e001900000000070704330000000000740435000000200550008c00004a2b0000c13d000000000001004b000000000e0c00190000000c0c00002900004a500000613d000000000d0300190000000b0700002900004a460000013d000000000d530019000000000005004b00004a410000613d0000000b0e000029000000000403001900000000e70e043400000000047404360000000000d4004b00004a3d0000c13d000000000001004b000000000e0c00190000000c0c00002900004a500000613d0000000b07500029000000030110021000000000040d043300000000041401cf000000000414022f00000000050704330000010001100089000000000515022f00000000011501cf000000000141019f00000000001d04350000000003360019000000000003043500000000050a0433000015f6065001970000001f0150018f00000000003c004b00004a670000813d000000000006004b00004a630000613d00000000041c00190000000007130019000000200a70008a000000200d40008a00000000046a001900000000076d001900000000070704330000000000740435000000200660008c00004a5d0000c13d000000000001004b00004a7d0000613d000000000a03001900004a730000013d000000000a630019000000000006004b00004a700000613d000000000d0c0019000000000403001900000000d70d043400000000047404360000000000a4004b00004a6c0000c13d000000000001004b00004a7d0000613d000000000c6c0019000000030110021000000000040a043300000000041401cf000000000414022f00000000060c04330000010001100089000000000616022f00000000011601cf000000000141019f00000000001a04350000000904000029000000070440035f0000000001350019000015f6052001980000001f0620018f0000000000010435000000000351001900004a8b0000613d000000000a04034f000000000c01001900000000a70a043c000000000c7c043600000000003c004b00004a870000c13d000000000006004b00004a980000613d000000000454034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000001210019000000000001043500000000020b0433000015f6042001970000001f0320018f00000000001e004b00004aaf0000813d000000000004004b00004aab0000613d00000000063e00190000000005310019000000200550008a000000200660008a0000000007450019000000000a460019000000000a0a04330000000000a70435000000200440008c00004aa50000c13d000000000003004b00004ac50000613d000000000501001900004abb0000013d0000000005410019000000000004004b00004ab80000613d00000000060e0019000000000a0100190000000067060434000000000a7a043600000000005a004b00004ab40000c13d000000000003004b00004ac50000613d000000000e4e00190000000303300210000000000405043300000000043401cf000000000434022f00000000060e04330000010003300089000000000636022f00000000033601cf000000000343019f0000000000350435000000000112001900000000000104350000000001810049000000200210008a00000000002804350000001f01100039000015f6021001970000000001820019000000000021004b00000000020000390000000102004039000015070010009c00004c250000213d000000010020019000004c250000c13d000000400010043f000015010090009c000015010900804100000040019002100000000002080433000015010020009c00001501020080410000006002200210000000000112019f000000000200041400004c1a0000013d0000006009000039000000800b00003900004aef0000013d000015860090009c00004c250000213d0000004002900039000000400020043f0000000102000039000000000b2904360000000a0200035f000000000202043b000015cf02200197000000f803100210000000000232019f00001556022001c700000000002b0435000000400a00043d0000158600a0009c00004c250000213d0000004002a00039000000400020043f0000000102000039000000000d2a04360000000a0200035f000000000202043b000015cf0520019700001602025001c700000000002d043500000000020c0433000000000221001900000000040904330000000002420019000000400600043d00000001022000390000150702200197000000380020008c000c00000008001d00004b200000413d000015860060009c00004c250000213d000015010020009c00000000040200190000002004402270000000000700003900000004070020390000ffff0040008c00000002077021bf00000010044022700000004008600039000000400080043f000000ff0040008c00000001077021bf000000f804700210000000000454019f00001604044001c7000000200c60003900000000004c04350000000304700210000000f80440015f00000000024201cf000000210460003900000000002404350000000202700039000000000026043500004b2a0000013d000015860060009c00004c250000213d0000004004600039000000400040043f0000000103000039000000000c360436000000f802200210000000000252019f000016030220009a00000000002c0435000a0000000d001d000000400500043d00000020085000390000157402000041000000000028043500000000060604330000000007f6016f0000001f0e60018f000000210450003900000000004c004b00004b450000813d000000000007004b00004b410000613d000000000dec00190000000002e40019000000200220008a000000200fd0008a000000000d72001900000000037f0019000000000303043300000000003d0435000000200770008c00004b3b0000c13d00000000000e004b000000000204001900004b510000c13d00004b5b0000013d0000000002740019000000000007004b00004b4e0000613d000000000f0c0019000000000d04001900000000f30f0434000000000d3d043600000000002d004b00004b4a0000c13d00000000000e004b00004b5b0000613d000000000c7c00190000000303e00210000000000702043300000000073701cf000000000737022f000000000c0c04330000010003300089000000000c3c022f00000000033c01cf000000000373019f00000000003204350000000006460019000000000006043500000004020000290000000007020433000015f60d7001970000001f0c70018f000000090060006b00004b740000813d00000000000d004b00004b6f0000613d0000000903c000290000000002c60019000000200220008a000000200e30008a0000000003d200190000000004de001900000000040404330000000000430435000000200dd0008c00004b690000c13d00000000000c004b00004b8a0000613d0000000002060019000000090e00002900004b800000013d0000000002d6001900000000000d004b00004b7d0000613d000000090e000029000000000406001900000000e30e04340000000004340436000000000024004b00004b790000c13d00000000000c004b00004b8a0000613d000000090ed000290000000303c00210000000000402043300000000043401cf000000000434022f000000000c0e04330000010003300089000000000c3c022f00000000033c01cf000000000343019f0000000000320435000000000667001900000000000604350000000007090433000015f60c7001970000001f0970018f00000000006b004b00004ba20000813d00000000000c004b00004b9d0000613d00000000039b00190000000002960019000000200220008a000000200d30008a0000000003c200190000000004cd001900000000040404330000000000430435000000200cc0008c00004b970000c13d000000000009004b0000000a0d00002900004bb90000613d000000000206001900004baf0000013d0000000002c6001900000000000c004b00004bab0000613d000000000d0b0019000000000406001900000000d30d04340000000004340436000000000024004b00004ba70000c13d000000000009004b0000000a0d00002900004bb90000613d000000000bcb00190000000303900210000000000402043300000000043401cf000000000434022f00000000090b04330000010003300089000000000939022f00000000033901cf000000000343019f00000000003204350000000c030000290000000b0930035f0000000002670019000015f6061001980000001f0710018f0000000000020435000000000462001900004bc70000613d000000000b09034f000000000c02001900000000b30b043c000000000c3c043600000000004c004b00004bc30000c13d000000000007004b00004bd40000613d000000000369034f0000000306700210000000000704043300000000076701cf000000000767022f000000000303043b0000010006600089000000000363022f00000000036301cf000000000373019f00000000003404350000000001120019000000000001043500000000020a0433000015f6062001970000001f0420018f00000000001d004b00004beb0000813d000000000006004b00004be70000613d00000000034d00190000000007410019000000200770008a000000200930008a0000000003670019000000000a690019000000000a0a04330000000000a30435000000200660008c00004be10000c13d000000000004004b00004c010000613d000000000701001900004bf70000013d0000000007610019000000000006004b00004bf40000613d00000000090d0019000000000a0100190000000093090434000000000a3a043600000000007a004b00004bf00000c13d000000000004004b00004c010000613d000000000d6d00190000000303400210000000000407043300000000043401cf000000000434022f00000000060d04330000010003300089000000000636022f00000000033601cf000000000343019f0000000000370435000000000112001900000000000104350000000001510049000000200210008a00000000002504350000001f01100039000015f6021001970000000001520019000000000021004b00000000020000390000000102004039000015070010009c00004c250000213d000000010020019000004c250000c13d000000400010043f000015010080009c000015010800804100000040018002100000000002050433000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f000000010020019000004c2b0000613d000000000101043b000000000001042d000015d701000041000000000010043f0000004101000039000000040010043f0000159801000041000054010001043000000000010000190000540100010430000015d701000041000000000010043f0000003201000039000000040010043f00001598010000410000540100010430000000000001042f000000400100043d00000044021000390000156d0300004100000000003204350000002402100039000000080300003900004c4e0000013d000000400100043d00000044021000390000160503000041000000000032043500000024021000390000001f0300003900004c4e0000013d000015d701000041000000000010043f0000001101000039000000040010043f00001598010000410000540100010430000000400100043d00000044021000390000160d0300004100000000003204350000002402100039000000170300003900000000003204350000156c020000410000000000210435000000040210003900000020030000390000000000320435000015010010009c000015010100804100000040011002100000156e011001c700005401000104300000001f0340018f000015030240019800004c620000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b00004c5e0000c13d000000000003004b00004c6f0000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000005401000104300000001f0430018f000015030230019800004c7a0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b00004c760000c13d000000000004004b00004c870000613d000000000121034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000600130021000005401000104300006000000000002000000400020008c00004eff0000c13d000000400600043d0000004002600039000600000001001d00000012031003670000000004060019000000003503043c0000000004540436000000000024004b00004c910000c13d000015a8030000410000000000320435000015010060009c000015010600804100000040016002100000000002000414000015010020009c0000150102008041000000c002200210000000000112019f0000160f011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000101043b000000000101041a000000010210019000000001011002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000032004b00004ef90000c13d000000000001004b00004f030000c13d000000400100043d000016110010009c00004ef30000813d0000004002100039000000400020043f000000010200003900000000012104360000000000010435000000400100043d0000000102100039000015a80300004100000000003204350000000002010433000015cf022001970000000000210435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015d1011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000101043b000000000201041a000000010320019000000001062002700000007f0660618f0000001f0060008c00000000040000390000000104002039000000000442013f000000010040019000004ef90000c13d000000400500043d0000000004650436000000000003004b000500000005001d000400000004001d00004cf70000613d000300000006001d000000000010043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d0000000307000029000000000007004b00004cfd0000613d000000000201043b0000000001000019000000050500002900000004060000290000000003160019000000000402041a000000000043043500000001022000390000002001100039000000000071004b00004cef0000413d00004cff0000013d000015f8012001970000000000140435000000000006004b0000002001000039000000000100603900004cff0000013d000000000100001900000005050000290000003f01100039000015f6021001970000000001520019000000000021004b00000000020000390000000102004039000015070010009c00004ef30000213d000000010020019000004ef30000c13d000000400010043f0000000002050433000000000002004b00004dd90000613d000015860010009c00004ef30000213d0000004002100039000000400020043f000000010200003900000000012104360000000000010435000000400100043d0000000102100039000015a80300004100000000003204350000000002010433000015cf022001970000000000210435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015d1011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000301043b000000000103041a000000010010019000000001041002700000007f0440618f0000001f0040008c00000000020000390000000102002039000000000121013f000000010010019000004ef90000c13d000000200040008c000300000003001d00004d4e0000413d000200000004001d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000201043b00000002010000290000001f01100039000000050110027000000000011200190000000202200039000000000012004b000000030300002900004d4e0000813d000000000002041b0000000102200039000000000012004b00004d4a0000413d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000201043b00000006050000290000001201500367000000000401043b000000000042041b00000020045000390000001203400367000000000303043b0000000102200039000000000032041b00000081020000390000000303000029000000000023041b000000400200043d00000040032000390000000004020019000000001501043c0000000004540436000000000034004b00004d680000c13d000015a8010000410000000000130435000015010020009c000015010200804100000040012002100000000002000414000015010020009c0000150102008041000000c002200210000000000112019f0000160f011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000501043b00000005010000290000000004010433000015070040009c00004ef30000213d000000000105041a000000010010019000000001031002700000007f0330618f0000001f0030008c00000000020000390000000102002039000000000121013f000000010010019000004ef90000c13d000000200030008c000300000005001d000200000004001d00004dab0000413d000100000003001d000000000050043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d00000002040000290000001f024000390000000502200270000000200040008c0000000002004019000000000301043b00000001010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000000030500002900004dab0000813d000000000002041b0000000102200039000000000012004b00004da70000413d000000200040008c000000040300002900004ead0000413d000000000050043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d0000000207000029000015f602700198000000000101043b00004ec60000613d000000010320008a0000000503300270000000000331001900000020060000390000000103300039000000050500002900000000045600190000000004040433000000000041041b00000020066000390000000101100039000000000031004b00004dc20000c13d000000000072004b00004dd30000813d0000000302700210000000f80220018f000015f70220027f000015f70220016700000000035600190000000003030433000000000223016f000000000021041b000000010170021000000001011001bf00000006040000290000000305000029000000000015041b00004ed30000013d000015860010009c00004ef30000213d0000004002100039000000400020043f000000010200003900000000012104360000000000010435000000400100043d0000000102100039000015a80300004100000000003204350000000002010433000015cf022001970000000000210435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f000015d1011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000301043b000000000103041a000000010010019000000001041002700000007f0440618f0000001f0040008c00000000020000390000000102002039000000000121013f000000010010019000004ef90000c13d000000200040008c000500000003001d00004e1a0000413d000400000004001d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000201043b00000004010000290000001f01100039000000050110027000000000011200190000000202200039000000000012004b000000050300002900004e1a0000813d000000000002041b0000000102200039000000000012004b00004e160000413d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000201043b00000006050000290000001201500367000000000401043b000000000042041b00000020045000390000001203400367000000000303043b0000000102200039000000000032041b00000081020000390000000503000029000000000023041b000000400300043d000015860030009c00004ef30000213d0000004002300039000000400020043f0000000102000039000500000003001d0000000002230436000200000002001d0000000000020435000000400200043d00000040032000390000000004020019000000001501043c0000000004540436000000000034004b00004e3e0000c13d000015a8010000410000000000130435000015010020009c000015010200804100000040012002100000000002000414000015010020009c0000150102008041000000c002200210000000000112019f0000160f011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d000000000301043b00000005010000290000000004010433000015070040009c00004ef30000213d000000000103041a000000010010019000000001051002700000007f0550618f0000001f0050008c00000000020000390000000102002039000000000121013f000000010010019000004ef90000c13d000000200050008c000400000003001d000300000004001d00004e810000413d000100000005001d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d00000003040000290000001f024000390000000502200270000000200040008c0000000002004019000000000301043b00000001010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000000040300002900004e810000813d000000000002041b0000000102200039000000000012004b00004e7d0000413d000000200040008c00004eb70000413d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f000000010020019000004ef10000613d0000000307000029000015f602700198000000000101043b00004ecb0000613d000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000050600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b00004e970000c13d000000000072004b00004ea80000813d0000000302700210000000f80220018f000015f70220027f000015f70220016700000000036300190000000003030433000000000223016f000000000021041b000000010170021000000001011001bf0000000604000029000000040300002900004ed20000013d000000000004004b00004ec20000613d0000000301400210000015f70110027f000015f7011001670000000002030433000000000112016f0000000102400210000000000121019f00004ec30000013d000000000004004b00004ed00000613d0000000301400210000015f70110027f000015f70110016700000002020000290000000002020433000000000112016f0000000102400210000000000121019f00004ed10000013d00000000010000190000000604000029000000000015041b00004ed30000013d00000005050000290000002006000039000000000072004b00004dcb0000413d00004dd30000013d00000020030000390000000506000029000000000072004b00004ea00000413d00004ea80000013d00000000010000190000000604000029000000000013041b000000400100043d00000020021000390000004003000039000000000032043500000020020000390000000000210435000000800210003900000040031000390000001204400367000000004504043c0000000003530436000000000023004b00004edc0000c13d0000000000020435000015010010009c000015010100804100000040011002100000000002000414000015010020009c0000150102008041000000c002200210000000000121019f00001612011001c70000800d020000390000000103000039000016130400004153ff53eb0000040f000000010020019000004ef10000613d000000000001042d00000000010000190000540100010430000015d701000041000000000010043f0000004101000039000000040010043f00001598010000410000540100010430000015d701000041000000000010043f0000002201000039000000040010043f000015980100004100005401000104300000160e01000041000000000010043f000015710100004100005401000104300000161001000041000000000010043f0000157101000041000054010001043000010000000000020000150401100197000000010010008c00004f350000a13d000100000001001d000000000010043f0000155801000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f000000010020019000004f330000613d000000000101043b000000000101041a000015040010019800004f1f0000613d0000000101000039000000010110018f000000000001042d0000000101000029000000000010043f0000156201000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f000000010020019000004f330000613d000000000101043b000000000101041a00001504001001980000000001000039000000010100c039000000010110018f000000000001042d00000000010000190000540100010430000015f001000041000000000010043f00001571010000410000540100010430000500000000000200000000060100190000000001000415000200000001001d000000400100043d00000020021000390000157e0300004100000000003204350000002404100039000000000034043500000024070000390000000000710435000015f90010009c0000505e0000813d0000006003100039000000400030043f000000040060008c000300000006001d00004f500000c13d0000000001020433000000000010043f000000010300003100004f7d0000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c7000000000206001953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000004f690000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00004f650000c13d000000000005004b00004f760000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0013000000010355000000010020019000000003060000290000002407000039000050680000613d000000000100043d000000200030008c000050680000413d000000000001004b000050680000613d000000400100043d00000020021000390000157e04000041000000000042043500000024041000390000158005000041000000000054043500000000007104350000155a0010009c0000505e0000213d0000006004100039000000400040043f000000040060008c00004f920000c13d0000000001020433000000000010043f00004fc60000013d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c7000000000206001953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000004fab0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00004fa70000c13d000000000005004b00004fb80000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350013000000010355000100000003001f0000001f0030008c00000000010000390000000101002039000000000112016f0000000008000415000000050880008a0000000508800210000000010010008c00004fcc0000c13d000000000100043d000000030600002900000024070000390000000008000415000000040880008a0000000508800210000000000001004b00004fce0000613d000050680000013d00000003060000290000002407000039000000400100043d00000020021000390000157e0400004100000000004204350000002404100039000015eb05000041000000000054043500000000007104350000155a0010009c0000505e0000213d0000006004100039000000400040043f000000040060008c00004fdf0000c13d0000000001020433000000000010043f0000500d0000013d000100000008001d000015010020009c000015010200804100000040022002100000000001010433000015010010009c00001501010080410000006001100210000000000121019f0000157f011001c7000000000206001953ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000004ff90000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00004ff50000c13d000000000005004b000050060000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0013000000010355000000010020019000000003060000290000000108000029000050660000613d000000000100043d0000001f0030008c000050660000a13d000000000001004b0000000501800270000000000100003f000000010100c03f0000000001000415000000020110006900000000010000020000506b0000613d0000150401600197000000010010008c0000506f0000a13d000300000001001d000000000010043f0000157a01000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000050640000613d000000000101043b000000000101041a0000150400100198000050730000c13d000015c601000041000000000201041a0000157c032001970000000304000029000000000343019f000000000031041b000000000040043f0000157a01000041000000200010043f0000150401200198000050420000613d000200000001001d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000050640000613d00000002030000290000504c0000013d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000050640000613d0000000103000039000000000101043b000000000201041a0000157c02200197000000000232019f000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d0200003900000002030000390000161404000041000000030500002953ff53eb0000040f0000000100200190000050640000613d000000000001042d000015d701000041000000000010043f0000004101000039000000040010043f00001598010000410000540100010430000000000100001900005401000104300000000501800270000000000100003f000000000100041500000002011000690000000001000002000015df01000041000000000010043f00001571010000410000540100010430000015f001000041000000000010043f000015710100004100005401000104300000159a01000041000000000010043f0000157101000041000054010001043000020000000000020000150401100197000000010010008c000050c10000a13d000200000001001d000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000050bf0000613d000000000101043b000000000101041a0000150400100198000050c50000c13d0000159b01000041000000000201041a0000157c032001970000000204000029000000000343019f000000000031041b000000000040043f0000155401000041000000200010043f0000150401200198000050a30000613d000100000001001d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000050bf0000613d0000000103000029000050ad0000013d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000050bf0000613d0000000103000039000000000101043b000000000201041a0000157c02200197000000000232019f000000000021041b0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d0200003900000002030000390000159c04000041000000020500002953ff53eb0000040f0000000100200190000050bf0000613d000000000001042d00000000010000190000540100010430000015f001000041000000000010043f000015710100004100005401000104300000159a01000041000000000010043f0000157101000041000054010001043000090000000000020000000003010019000200000002001d0006001400200094000052880000413d000300000003001d0000001201300367000000000701043b0000000001000415000400000001001d000000400100043d00000020051000390000157e0300004100000000003504350000002404100039000000000034043500000024080000390000000000810435000015f90010009c000052790000813d00000060027002700000006003100039000000400030043f000000040020008c000700000002001d000500000007001d000050e80000c13d0000000001050433000000000010043f0000000103000031000051150000013d000015010050009c000015010500804100000040035002100000000001010433000015010010009c00001501010080410000006001100210000000000131019f0000157f011001c753ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000051000000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000050fc0000c13d000000000005004b00000024080000390000510e0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0013000000010355000000010020019000000007020000290000000507000029000052810000613d000000000100043d000000200030008c000052810000413d000000000001004b000052810000613d000000400100043d00000020061000390000157e04000041000000000046043500000024041000390000158005000041000000000054043500000000008104350000155a0010009c000052790000213d0000006004100039000000400040043f000000040020008c0000512a0000c13d0000000001060433000000000010043f0000515e0000013d000015010060009c000015010600804100000040036002100000000001010433000015010010009c00001501010080410000006001100210000000000131019f0000157f011001c753ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000051420000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000513e0000c13d000000000005004b0000514f0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350013000000010355000100000003001f0000001f0030008c00000000010000390000000101002039000000000112016f0000000006000415000000090660008a0000000506600210000000010010008c0000002408000039000051640000c13d000000000100043d000000070200002900000005070000290000000006000415000000080660008a0000000506600210000000000001004b000051660000613d000052810000013d00000007020000290000000507000029000000400100043d00000020051000390000157e0400004100000000004504350000000000810435000000240410003900000000000404350000155a0010009c000052790000213d0000006004100039000000400040043f000000040020008c000051760000c13d0000000001050433000000000010043f000051a40000013d000100000006001d000015010050009c000015010500804100000040035002100000000001010433000015010010009c00001501010080410000006001100210000000000131019f0000157f011001c753ff53f00000040f00000060031002700000150103300197000000200030008c000000200400003900000000040340190000001f0540018f00000020044001900000518f0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000518b0000c13d000000000005004b0000519c0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f001300000001035500000001002001900000000702000029000000050700002900000001060000290000527f0000613d000000000100043d000000200030008c0000527f0000413d000000000001004b0000000501600270000000000100003f000000010100c03f000000000100041500000004011000690000000001000002000052840000613d000016150070009c0000528c0000a13d000000000020043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052770000613d000000000101043b000000000101041a0000150400100198000052900000c13d0000000101000039000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052770000613d000000000101043b000000000101041a0000000102000039000000000020043f0000157702000041000000200020043f0000150401100198000051f30000613d000500000001001d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052770000613d000000000101043b000000000201041a0000157c022001970000000703000029000000000232019f000000000021041b000000000030043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052770000613d00000005030000290000520f0000013d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052770000613d000000000101043b000000000201041a0000157c022001970000000703000029000000000232019f000000000021041b000000000030043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052770000613d0000000103000039000000000101043b000000000201041a0000157c02200197000000000232019f000000000021041b00001569010000410000000000100443000000070100002900000004001004430000000001000414000015010010009c0000150101008041000000c0011002100000156a011001c7000080020200003953ff53f00000040f0000000100200190000052940000613d000000000101043b000000000001004b000052770000613d000000400a00043d000015e20100004100000000001a04350000000401a00039000000200200003900000000002104350000002401a0003900000006020000290000000000210435000015f6042001980000001f0520018f0000004402a0003900000000034200190000000306000029000000140660003900000012066003670000523b0000613d000000000706034f0000000008020019000000007907043c0000000008980436000000000038004b000052370000c13d000000000005004b000052480000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000602200029000000000002043500000000020004140000000705000029000000040050008c000052680000613d00000002030000290000000b03300039000015f6013001970000004401100039000015010010009c000015010100804100000060011002100000150100a0009c000015010300004100000000030a40190000004003300210000000000131019f000015010020009c0000150102008041000000c002200210000000000112019f000000000205001900060000000a001d53ff53eb0000040f000000060a00002900000007050000290000006003100270000115010030019d00130000000103550000000100200190000052950000613d0000150700a0009c000052790000213d0000004000a0043f0000000001000414000015010010009c0000150101008041000000c00110021000001574011001c70000800d020000390000000203000039000016160400004153ff53eb0000040f0000000100200190000052770000613d000000000001042d00000000010000190000540100010430000015d701000041000000000010043f0000004101000039000000040010043f000015980100004100005401000104300000000501600270000000000100003f0000000001000415000000040110006900000000010000020000161701000041000000000010043f000015710100004100005401000104300000161801000041000000000010043f00001571010000410000540100010430000015f001000041000000000010043f000015710100004100005401000104300000159a01000041000000000010043f00001571010000410000540100010430000000000001042f00001501033001970000001f0530018f0000150306300198000000400200043d0000000004620019000052a10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000529d0000c13d000000000005004b000052ae0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015010020009c00001501020080410000004002200210000000000112019f00005401000104300000150401100197000000010010008c000052c90000a13d000000000010043f0000157701000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052cd0000613d000000000101043b000000000101041a00001504001001980000000001000039000000010100c039000000000001042d000015f001000041000000000010043f00001571010000410000540100010430000000000100001900005401000104300000150401100197000000010010008c000052e40000a13d000000000010043f0000155401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000052e80000613d000000000101043b000000000101041a00001504001001980000000001000039000000010100c039000000000001042d000015f001000041000000000010043f000015710100004100005401000104300000000001000019000054010001043000030000000000020000157900200198000053560000613d0000150402200197000200000002001d000000000020043f000300000001001d000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053540000613d000000000101043b000000000101041a00001504001001980000535a0000c13d0000000101000039000000000010043f0000000301000029000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053540000613d000000000101043b000000000101041a0000000102000039000000000020043f0000000302000029000000200020043f0000150401100198000053320000613d000100000001001d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053540000613d000000000101043b000000000201041a0000157c022001970000000203000029000000000232019f000000000021041b000000000030043f0000000301000029000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053540000613d00000001030000290000534e0000013d0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053540000613d000000000101043b000000000201041a0000157c022001970000000203000029000000000232019f000000000021041b000000000030043f0000000301000029000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053540000613d0000000103000039000000000101043b000000000201041a0000157c02200197000000000232019f000000000021041b000000000001042d00000000010000190000540100010430000015f001000041000000000010043f000015710100004100005401000104300000159a01000041000000000010043f0000157101000041000054010001043000020000000000020000150401100197000000000010043f0000156401000041000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053af0000613d000000000101043b0000156502000041000000000020043f000000200010043f0000000001000414000015010010009c0000150101008041000000c00110021000001555011001c7000080100200003953ff53f00000040f0000000100200190000053af0000613d000000000301043b000000000103041a000000010210019000000001041002700000007f0440618f0000001f0040008c00000000010000390000000101002039000000000012004b000053b10000c13d000000000004004b000053ae0000613d0000001f0040008c000053ad0000a13d000100000004001d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c70000801002000039000200000003001d53ff53f00000040f0000000100200190000053af0000613d0000000203000029000000000201043b00000001010000290000001f01100039000000050110027000000000011200190000000102200039000000000012004b000053a00000813d000000000002041b0000000102200039000000000012004b0000539c0000413d000000000030043f0000000001000414000015010010009c0000150101008041000000c00110021000001508011001c7000080100200003953ff53f00000040f0000000100200190000053af0000613d000000000301043b0000000202000029000000000002041b000000000003041b000000000001042d00000000010000190000540100010430000015d701000041000000000010043f0000002201000039000000040010043f00001598010000410000540100010430000000000001042f000015010010009c00001501010080410000004001100210000015010020009c00001501020080410000006002200210000000000112019f0000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001574011001c7000080100200003953ff53f00000040f0000000100200190000053cb0000613d000000000101043b000000000001042d0000000001000019000054010001043000000000050100190000000000200443000000050030008c000053db0000413d000000040100003900000000020000190000000506200210000000000664001900000005066002700000000006060031000000000161043a0000000102200039000000000031004b000053d30000413d000015010030009c000015010300804100000060013002100000000002000414000015010020009c0000150102008041000000c002200210000000000112019f00001619011001c7000000000205001953ff53f00000040f0000000100200190000053ea0000613d000000000101043b000000000001042d000000000001042f000053ee002104210000000102000039000000000001042d0000000002000019000000000001042d000053f3002104230000000102000039000000000001042d0000000002000019000000000001042d000053f8002104210000000102000039000000000001042d0000000002000019000000000001042d000053fd002104230000000102000039000000000001042d0000000002000019000000000001042d000053ff00000432000054000001042e00005401000104300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000fffffffffffffffffffffffffffffffffffffffff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a000000000000000000000000000000000000000000000000ff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff0200000000000000000000000000000000000020000000000000000000000000c7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d200000002000000000000000000000000000000800000010000000000000000000000000000000000000000000000000000000000000000000000000097b0ff6500000000000000000000000000000000000000000000000000000000cf23b00400000000000000000000000000000000000000000000000000000000e1abc36800000000000000000000000000000000000000000000000000000000ea7ef14300000000000000000000000000000000000000000000000000000000f23a6e6000000000000000000000000000000000000000000000000000000000f23a6e6100000000000000000000000000000000000000000000000000000000ffa1ad7400000000000000000000000000000000000000000000000000000000ea7ef14400000000000000000000000000000000000000000000000000000000eeb8cb0900000000000000000000000000000000000000000000000000000000e1abc36900000000000000000000000000000000000000000000000000000000e2f318e300000000000000000000000000000000000000000000000000000000e4786c6200000000000000000000000000000000000000000000000000000000d50d466200000000000000000000000000000000000000000000000000000000d50d466300000000000000000000000000000000000000000000000000000000db8a323f00000000000000000000000000000000000000000000000000000000df9c158900000000000000000000000000000000000000000000000000000000cf23b00500000000000000000000000000000000000000000000000000000000d267652900000000000000000000000000000000000000000000000000000000d3bdf4b500000000000000000000000000000000000000000000000000000000ae9411aa00000000000000000000000000000000000000000000000000000000b97a231800000000000000000000000000000000000000000000000000000000be9c570200000000000000000000000000000000000000000000000000000000be9c570300000000000000000000000000000000000000000000000000000000bffae43000000000000000000000000000000000000000000000000000000000b97a231900000000000000000000000000000000000000000000000000000000bc197c8100000000000000000000000000000000000000000000000000000000ae9411ab00000000000000000000000000000000000000000000000000000000b4e581f500000000000000000000000000000000000000000000000000000000b964481200000000000000000000000000000000000000000000000000000000a1c428cb00000000000000000000000000000000000000000000000000000000a1c428cc00000000000000000000000000000000000000000000000000000000a28c1aee00000000000000000000000000000000000000000000000000000000a9951fff0000000000000000000000000000000000000000000000000000000097b0ff66000000000000000000000000000000000000000000000000000000009b7be15600000000000000000000000000000000000000000000000000000000a06324610000000000000000000000000000000000000000000000000000000042f6e38800000000000000000000000000000000000000000000000000000000707a10ca0000000000000000000000000000000000000000000000000000000085867cde000000000000000000000000000000000000000000000000000000008ba5a410000000000000000000000000000000000000000000000000000000008ba5a411000000000000000000000000000000000000000000000000000000008f0273a90000000000000000000000000000000000000000000000000000000085867cdf0000000000000000000000000000000000000000000000000000000087cf8b7800000000000000000000000000000000000000000000000000000000707a10cb000000000000000000000000000000000000000000000000000000007cc71f230000000000000000000000000000000000000000000000000000000084b0196e00000000000000000000000000000000000000000000000000000000564d2e4500000000000000000000000000000000000000000000000000000000564d2e4600000000000000000000000000000000000000000000000000000000624d2b530000000000000000000000000000000000000000000000000000000063e5a9270000000000000000000000000000000000000000000000000000000042f6e389000000000000000000000000000000000000000000000000000000004cfa6487000000000000000000000000000000000000000000000000000000004f09a9d8000000000000000000000000000000000000000000000000000000002e0b437c000000000000000000000000000000000000000000000000000000003b3fa34d000000000000000000000000000000000000000000000000000000003b3fa34e000000000000000000000000000000000000000000000000000000003d3a69bf000000000000000000000000000000000000000000000000000000003e19d05d000000000000000000000000000000000000000000000000000000002e0b437d0000000000000000000000000000000000000000000000000000000033713880000000000000000000000000000000000000000000000000000000003659cfe6000000000000000000000000000000000000000000000000000000001626ba7d000000000000000000000000000000000000000000000000000000001626ba7e00000000000000000000000000000000000000000000000000000000202bcce70000000000000000000000000000000000000000000000000000000025f761f50000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000000f84248b00000000000000000000000000000000000000000000000000000000150b7a020000000000000000000000000000000000000020000000800000000000000000f23a6e610000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff67641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d42e020000000000000000000000000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe067641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d4fbe1239cd800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff9f000000000000000000000000000000000000000000000000000000010000000000000000ffffffff000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffe000000000000000000000000000000000000000000000000000000000ffffffff000000000000000000000000000000000000000000000000ffffffff000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe067641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d4fc926a74a60000000000000000000000000000000000000000000000000000000067641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d4fd8d06c4ef568dbd273d67f28e87029582dedfb4085cb53c6b84616d8831065bb500000000000000000000000000000000ffffffffffffffffffffffffffffffff010000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b8302000002000000000000000000000000000000240000000000000000000000003920e5390000000000000000000000000000000000000000000000000000000008c379a0000000000000000000000000000000000000000000000000000000004f766572666c6f7700000000000000000000000000000000000000000000000000000000000000000000000000000000000000640000000000000000000000006d8bb2780000000000000000000000000000000000000000000000000000000052c9d27a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000fc82da4e00000000000000000000000000000000000000000000000000000000310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e02000000000000000000000000000000000000000000000000000000000000003d40a3a300000000000000000000000000000000000000000000000000000000aaeea0b595e409578c26dd16fa1bdb3a29a4d874694ecef3ca96376940f5fbfb67641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d4c800000000000000000000000000000000000000000000003fffffffffffffffe0000000000000000000000000fffffffffffffffffffffffffffffffffffffffe67641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d49567641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d496ffffffffffffffffffffffff00000000000000000000000000000000000000003e7bbd3c7108ea778643541ecdd4190952e9b830ef11881e275a17f252c50d1e01ffc9a7000000000000000000000000000000000000000000000000000000000000000000007530000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000000023316ac0000000000000000000000000000000000000000000000000000000067641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d494bf0a59f310a03be772f83999f5177981385f369c6a3660902345ff62e40cbd16d523306f060d63ffb85810c17d8a4cb5f880278b48224c9f2799510f7b848ae62f2770db00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf000000000000000000000000000000000000000000000000ffffffffffffffdf6897eb838573c2f80fc5ab6bd5e50086381eec1e2da3d555ce528b1921b31494bc197c8100000000000000000000000000000000000000000000000000000000360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbcffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffffff00000000000000000100000000000000000000000000000000000000000000000100000000000000004162737472616374476c6f62616c57616c6c6574000000000000000000000000312e302e30000000000000000000000000000000000000000000000000000000a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d102bd52a2c1e0d1918f12309266e475cfdc2c0357fb85ecea6d0612460264762a8342ad5d3e1f2e6e70edcf6d991b8a3023d3fca8047a131592f9edb9fd9b89d57dbd52a2c1e0d1918f12309266e475cfdc2c0357fb85ecea6d0612460264762a82a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d103a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d1017603cc860000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000008b3152e600000000000000000000000000000000000000000000000000000000f2d4d19100000000000000000000000000000000000000000000000000000000092d05b7d1becee21b6a436daa7383e2909f8a87437c18f59d808e272ec5f981e5c6beb032e65f562ed120c1d9a89693d62cbb93b71964e171b3c557ddf6f6d2c43ead1400000000000000000000000000000000000000000000000000000000d42ab69c000000000000000000000000000000000000000000000000000000000200000200000000000000000000000000000044000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffd7e6bcf800000000000000000000000000000000000000000000000000000000f92ee8a900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7f0200000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000a000000000000000002cf7b9c800000000000000000000000000000000000000000000000000000000574a805d0000000000000000000000000000000000000000000000000000000067641650ff26a63f6b1fb8b1cb96de5bac5c28fcfcca35c9518ea6966d32d42ddfd95db7551104dbdb182155b57bca09a2ee8ab0f9fb3df0ef1baa3eff334f81689908a6000000000000000000000000000000000000000000000000000000008c5a344500000000000000000000000000000000000000000000000000000000949431dc00000000000000000000000000000000000000000000000000000000dd62ed3e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000800000000000000000095ea7b3000000000000000000000000000000000000000000000000000000005361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564000000000000000000000000000000000000000000000001ffffffffffffffe0000000000000000000000000000000000000000000000003ffffffffffffffe000000000000000000000000000000000000000440000000000000000000000005361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f20746f206e6f6e2d7a65726f20616c6c6f77616e6365000000000000000000000000000000000000000000000000000000000084000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff3f6f742073756363656564000000000000000000000000000000000000000000005361666545524332303a204552433230206f7065726174696f6e20646964206e416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000054686520617070726f76616c4261736564207061796d617374657220696e707574206d757374206265206174206c65617374203638206279746573206c6f6e670000000000000000000000000000000000000084000000800000000000000000556e737570706f72746564207061796d617374657220666c6f770000000000000000000000000000000000000000000000000064000000800000000000000000546865207374616e64617264207061796d617374657220696e707574206d757374206265206174206c656173742034206279746573206c6f6e6700000000000075f4e5771d2cdd015405ae76feb37f5792736e71ff18f8a9dd690772a48111a3f27936f804721ef15c1d3c400f938f12cc0b01773d868b1a0c64a478aa2f5acd84aed38d000000000000000000000000000000000000000000000000000000004a09443100000000000000000000000000000000000000000000000000000000333c07a0cda1dc28bd776072d89c708c4a48979391dfc4e7cabefec7d44b78e7c21d183920f926a6005b67cc3be728acefe352e163925e685a7a105dc3c09177d7c64d89000000000000000000000000000000000000000000000000000000001c334118468bfd2aaf55a01d63456d9c538a41e57aac74ff33bf6975696323f34549503731323a20556e696e697469616c697a656400000000000000000000005f9ce34815f8e11431c7bb75a8e6886a91478f7ffc1dbb0a98dc240fddd76b759a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b02000002000000000000000000000000000000040000000000000000000000000f0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0200000000000000000000000000000000000021000000c000000000000000000200000000000000000000000000000000000021000000000000000000000000ce7045bd00000000000000000000000000000000000000000000000000000000d675a4f100000000000000000000000000000000000000000000000000000000af2de182d8834b9fe85e7813dbe9c734d120f03c53aba204525a64107a941286c957eb7e00000000000000000000000000000000000000000000000000000000ad6ab975000000000000000000000000000000000000000000000000000000004e487b71000000000000000000000000000000000000000000000000000000000a1419aadbf31563778dcdd81bcb4c37b313e5796193bc1c61ad03c40962cc41a70c28d1000000000000000000000000000000000000000000000000000000005d611f318680d00598bb735d61bacf0c514c6b50e1e5ad30040a4df2b12791c75e741005000000000000000000000000000000000000000000000000000000007ecfb31c00000000000000000000000000000000000000000000000000000000a88b89a70000000000000000000000000000000000000000000000000000000013aca6de6c7b2435e3f6bbfdf41d0f3cfa5899b34e022be1f5791435669ee55f5d5273ad0000000000000000000000000000000000000000000000000000000022a1259f00000000000000000000000000000000000000000000000000000000ab4a919f000000000000000000000000000000000000000000000000000000004ddf47d40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffbbffffffffffffffffffffffffffffffffffffffbc00000000000000000000000099537950f7bf5606ecd5c5560b6ab422af3abf38a7c665932afc3ef9b19e54259f93f87d00000000000000000000000000000000000000000000000000000000413348ae0000000000000000000000000000000000000000000000000000000093887e3b000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000024000000a000000000000000009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f392250737a00000000000000000000000000000000000000000000000000000000d6443abb00000000000000000000000000000000000000000000000000000000202bcce700000000000000000000000000000000000000000000000000000000e7931438000000000000000000000000000000000000000000000000000000001626ba7e000000000000000000000000000000000000000000000000000000005963709b00000000000000000000000000000000000000000000000000000000150b7a0200000000000000000000000000000000000000000000000000000000b6dfaaff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff150b7a01ffffffffffffffffffffffffffffffffffffffffffffffffffffffff4e2312e000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000ffffffffffffffa0c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4708b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f190100000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000420000000000000000000000007f000000000000000000000000000000000000000000000000000000000000009400000000000000000000000000000000000000000000000000000000000000b8000000000000000000000000000000000000000000000000000000000000008100000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000f8000000000000000000000000000000000000000000000000000000000000006b656363616b3235362072657475726e656420696e76616c6964206461746100848e1bfa1ac4e3576b728bda6721b215c70a7799a5b4866282a71bab954baac8000000000000000000000000000000000000000000000000fffffffffffffe1fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6ead7c5bef027816a800da1736444fb58a807ef4c9603b7848673f7e3a68eb14a519b453ce45aaaaf3a300f5a9ec95869b4f28ab10430b572ee218c3a6a5e07d6f000000000000000000000000000000000000000000000000ffffffffffffff5f8080000000000000000000000000000000000000000000000000000000000000456e636f64696e6720756e737570706f7274656420747800000000000000000004c4d8f7000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000060000000000000000000000000df6cac6b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffc002000000000000000000000000000000000000800000000000000000000000007a23969418423fe577d13f10ff05cbafe27bb41fee0a0f76a6cb1b4fd66234edc0d8baad626c4aa48c9c04e59f797eb087f2e76bd1017d5325748f12b7fa5d440000000000000000000000000000000000000001ffffffffffffffffffffffff0e8ab0265c955b9584b70d255e316c63717f1fb52ba0acfff63bca74ca2e8fadc1ad2a5000000000000000000000000000000000000000000000000000000000912fe2f20000000000000000000000000000000000000000000000000000000002000002000000000000000000000000000000000000000000000000000000003c4e12b07ad58b1eb9b60a6cbd1b203eb87184a6773a573752495d608e8a9faf
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000074b9ae28ec45e3fa11533c7954752597c3de3e7a
-----Decoded View---------------
Arg [0] : knownTrustedEoaValidator (address): 0x74b9ae28EC45E3FA11533c7954752597C3De3e7A
-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 00000000000000000000000074b9ae28ec45e3fa11533c7954752597c3de3e7a
Loading...
Loading
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.