From 63368aca74fe91e44c4b2f25e74d713b81db3bcd Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Tue, 26 Mar 2024 15:42:07 +0530 Subject: [PATCH 01/17] feat: add deployments for XVS and XVSBridge --- .env.example | 4 +- .github/workflows/ci.yaml | 2 +- deployments/arbitrumsepolia/.chainId | 1 + .../arbitrumsepolia/DefaultProxyAdmin.json | 257 ++ deployments/arbitrumsepolia/XVS.json | 1109 ++++++++ .../arbitrumsepolia/XVSBridgeAdmin.json | 584 ++++ .../XVSBridgeAdmin_Implementation.json | 629 ++++ .../arbitrumsepolia/XVSBridgeAdmin_Proxy.json | 267 ++ .../arbitrumsepolia/XVSProxyOFTDest.json | 2518 +++++++++++++++++ .../0e89febeebc7444140de8e67c9067d2c.json | 78 + .../f2046c3ab03975d1be43bca1cf657398.json | 186 ++ hardhat.config.ts | 30 + helpers/deploymentConfig.ts | 38 + 13 files changed, 5701 insertions(+), 2 deletions(-) create mode 100644 deployments/arbitrumsepolia/.chainId create mode 100644 deployments/arbitrumsepolia/DefaultProxyAdmin.json create mode 100644 deployments/arbitrumsepolia/XVS.json create mode 100644 deployments/arbitrumsepolia/XVSBridgeAdmin.json create mode 100644 deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json create mode 100644 deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json create mode 100644 deployments/arbitrumsepolia/XVSProxyOFTDest.json create mode 100644 deployments/arbitrumsepolia/solcInputs/0e89febeebc7444140de8e67c9067d2c.json create mode 100644 deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json diff --git a/.env.example b/.env.example index e3b86a2..4a66e33 100644 --- a/.env.example +++ b/.env.example @@ -15,4 +15,6 @@ DEPLOYER_PRIVATE_KEY= #ARCHIVE_NODE_sepolia=https://ethereum-sepolia.blockpi.network/v1/rpc/public #ARCHIVE_NODE_ethereum=https://eth-mainnet.nodereal.io/v1/API_KEY #ARCHIVE_NODE_opbnbtestnet=https://opbnb-testnet.nodereal.io/v1/ -#ARCHIVE_NODE_opbnbmainnet=https://opbnb-mainnet.nodereal.io/v1/ \ No newline at end of file +#ARCHIVE_NODE_opbnbmainnet=https://opbnb-mainnet.nodereal.io/v1/ +#ARCHIVE_NODE_arbitrumsepolia="https://sepolia-rollup.arbitrum.io/rpc" +#ARCHIVE_NODE_arbitrumone="https://open-platform.nodereal.io//arbitrum-nitro/" \ No newline at end of file diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 7a90aa0..471204e 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -114,7 +114,7 @@ jobs: - name: Export deployments run: | - for NETWORK in bsctestnet bscmainnet ethereum sepolia opbnbtestnet opbnbmainnet; do + for NETWORK in bsctestnet bscmainnet ethereum sepolia opbnbtestnet opbnbmainnet arbitrumsepolia arbitrumone; do EXPORT=true yarn hardhat export --network ${NETWORK} --export ./deployments/${NETWORK}.json jq -M '{name, chainId, addresses: .contracts | map_values(.address)}' ./deployments/${NETWORK}.json > ./deployments/${NETWORK}_addresses.json done diff --git a/deployments/arbitrumsepolia/.chainId b/deployments/arbitrumsepolia/.chainId new file mode 100644 index 0000000..71ba4d6 --- /dev/null +++ b/deployments/arbitrumsepolia/.chainId @@ -0,0 +1 @@ +421614 \ No newline at end of file diff --git a/deployments/arbitrumsepolia/DefaultProxyAdmin.json b/deployments/arbitrumsepolia/DefaultProxyAdmin.json new file mode 100644 index 0000000..0717a5f --- /dev/null +++ b/deployments/arbitrumsepolia/DefaultProxyAdmin.json @@ -0,0 +1,257 @@ +{ + "address": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "initialOwner", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + }, + { + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "changeProxyAdmin", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + } + ], + "name": "getProxyAdmin", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + } + ], + "name": "getProxyImplementation", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + }, + { + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "upgrade", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + }, + { + "internalType": "address", + "name": "implementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + } + ], + "transactionHash": "0xb6fb511443bdc4feee3dd6c3c9f8b2625f62b8be86df092b7665328544f488ab", + "receipt": { + "to": null, + "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", + "contractAddress": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "transactionIndex": 1, + "gasUsed": "3327088", + "logsBloom": "0x00000000000000000000000000000000000000000000000000800000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800001000000000000000000000000000000000000020000000000000000000800000000000000000000200000000000400000000000000000000200000008000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0xa213c1110e421780dc94a130829f7a5641c711a4baa5bb2e66b242c6a5171efa", + "transactionHash": "0xb6fb511443bdc4feee3dd6c3c9f8b2625f62b8be86df092b7665328544f488ab", + "logs": [ + { + "transactionIndex": 1, + "blockNumber": 25719456, + "transactionHash": "0xb6fb511443bdc4feee3dd6c3c9f8b2625f62b8be86df092b7665328544f488ab", + "address": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "topics": [ + "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x0000000000000000000000001426a5ae009c4443188da8793751024e358a61c2" + ], + "data": "0x", + "logIndex": 0, + "blockHash": "0xa213c1110e421780dc94a130829f7a5641c711a4baa5bb2e66b242c6a5171efa" + } + ], + "blockNumber": 25719456, + "cumulativeGasUsed": "3327088", + "status": 1, + "byzantium": true + }, + "args": ["0x1426A5Ae009c4443188DA8793751024E358A61C2"], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initialOwner\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"inputs\":[{\"internalType\":\"contract TransparentUpgradeableProxy\",\"name\":\"proxy\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"changeProxyAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract TransparentUpgradeableProxy\",\"name\":\"proxy\",\"type\":\"address\"}],\"name\":\"getProxyAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract TransparentUpgradeableProxy\",\"name\":\"proxy\",\"type\":\"address\"}],\"name\":\"getProxyImplementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract TransparentUpgradeableProxy\",\"name\":\"proxy\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"upgrade\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract TransparentUpgradeableProxy\",\"name\":\"proxy\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"}],\"devdoc\":{\"details\":\"This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.\",\"kind\":\"dev\",\"methods\":{\"changeProxyAdmin(address,address)\":{\"details\":\"Changes the admin of `proxy` to `newAdmin`. Requirements: - This contract must be the current admin of `proxy`.\"},\"getProxyAdmin(address)\":{\"details\":\"Returns the current admin of `proxy`. Requirements: - This contract must be the admin of `proxy`.\"},\"getProxyImplementation(address)\":{\"details\":\"Returns the current implementation of `proxy`. Requirements: - This contract must be the admin of `proxy`.\"},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"renounceOwnership()\":{\"details\":\"Leaves the contract without owner. It will not be possible to call `onlyOwner` functions anymore. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.\"},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"upgrade(address,address)\":{\"details\":\"Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}. Requirements: - This contract must be the admin of `proxy`.\"},\"upgradeAndCall(address,address,bytes)\":{\"details\":\"Upgrades `proxy` to `implementation` and calls a function on the new implementation. See {TransparentUpgradeableProxy-upgradeToAndCall}. Requirements: - This contract must be the admin of `proxy`.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/openzeppelin/proxy/transparent/ProxyAdmin.sol\":\"ProxyAdmin\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor (address initialOwner) {\\n _transferOwnership(initialOwner);\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n _;\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions anymore. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby removing any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0x9b2bbba5bb04f53f277739c1cdff896ba8b3bf591cfc4eab2098c655e8ac251e\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/transparent/ProxyAdmin.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/ProxyAdmin.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./TransparentUpgradeableProxy.sol\\\";\\nimport \\\"../../access/Ownable.sol\\\";\\n\\n/**\\n * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an\\n * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.\\n */\\ncontract ProxyAdmin is Ownable {\\n\\n constructor (address initialOwner) Ownable(initialOwner) {}\\n\\n /**\\n * @dev Returns the current implementation of `proxy`.\\n *\\n * Requirements:\\n *\\n * - This contract must be the admin of `proxy`.\\n */\\n function getProxyImplementation(TransparentUpgradeableProxy proxy) public view virtual returns (address) {\\n // We need to manually run the static call since the getter cannot be flagged as view\\n // bytes4(keccak256(\\\"implementation()\\\")) == 0x5c60da1b\\n (bool success, bytes memory returndata) = address(proxy).staticcall(hex\\\"5c60da1b\\\");\\n require(success);\\n return abi.decode(returndata, (address));\\n }\\n\\n /**\\n * @dev Returns the current admin of `proxy`.\\n *\\n * Requirements:\\n *\\n * - This contract must be the admin of `proxy`.\\n */\\n function getProxyAdmin(TransparentUpgradeableProxy proxy) public view virtual returns (address) {\\n // We need to manually run the static call since the getter cannot be flagged as view\\n // bytes4(keccak256(\\\"admin()\\\")) == 0xf851a440\\n (bool success, bytes memory returndata) = address(proxy).staticcall(hex\\\"f851a440\\\");\\n require(success);\\n return abi.decode(returndata, (address));\\n }\\n\\n /**\\n * @dev Changes the admin of `proxy` to `newAdmin`.\\n *\\n * Requirements:\\n *\\n * - This contract must be the current admin of `proxy`.\\n */\\n function changeProxyAdmin(TransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {\\n proxy.changeAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.\\n *\\n * Requirements:\\n *\\n * - This contract must be the admin of `proxy`.\\n */\\n function upgrade(TransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {\\n proxy.upgradeTo(implementation);\\n }\\n\\n /**\\n * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See\\n * {TransparentUpgradeableProxy-upgradeToAndCall}.\\n *\\n * Requirements:\\n *\\n * - This contract must be the admin of `proxy`.\\n */\\n function upgradeAndCall(\\n TransparentUpgradeableProxy proxy,\\n address implementation,\\n bytes memory data\\n ) public payable virtual onlyOwner {\\n proxy.upgradeToAndCall{value: msg.value}(implementation, data);\\n }\\n}\\n\",\"keccak256\":\"0x754888b9c9ab5525343460b0a4fa2e2f4fca9b6a7e0e7ddea4154e2b1182a45d\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/transparent/TransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract TransparentUpgradeableProxy is ERC1967Proxy {\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _changeAdmin(admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.\\n */\\n function changeAdmin(address newAdmin) external virtual ifAdmin {\\n _changeAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n}\\n\",\"keccak256\":\"0x140055a64cf579d622e04f5a198595832bf2cb193cd0005f4f2d4d61ca906253\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x608060405234801561001057600080fd5b50604051610b17380380610b1783398101604081905261002f91610090565b8061003981610040565b50506100c0565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000602082840312156100a257600080fd5b81516001600160a01b03811681146100b957600080fd5b9392505050565b610a48806100cf6000396000f3fe60806040526004361061007b5760003560e01c80639623609d1161004e5780639623609d1461012b57806399a88ec41461013e578063f2fde38b1461015e578063f3b7dead1461017e57600080fd5b8063204e1c7a14610080578063715018a6146100c95780637eff275e146100e05780638da5cb5b14610100575b600080fd5b34801561008c57600080fd5b506100a061009b3660046107e4565b61019e565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d557600080fd5b506100de610255565b005b3480156100ec57600080fd5b506100de6100fb366004610808565b6102e7565b34801561010c57600080fd5b5060005473ffffffffffffffffffffffffffffffffffffffff166100a0565b6100de610139366004610870565b6103ee565b34801561014a57600080fd5b506100de610159366004610808565b6104fc565b34801561016a57600080fd5b506100de6101793660046107e4565b6105d1565b34801561018a57600080fd5b506100a06101993660046107e4565b610701565b60008060008373ffffffffffffffffffffffffffffffffffffffff166040516101ea907f5c60da1b00000000000000000000000000000000000000000000000000000000815260040190565b600060405180830381855afa9150503d8060008114610225576040519150601f19603f3d011682016040523d82523d6000602084013e61022a565b606091505b50915091508161023957600080fd5b8080602001905181019061024d9190610964565b949350505050565b60005473ffffffffffffffffffffffffffffffffffffffff1633146102db576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064015b60405180910390fd5b6102e5600061074d565b565b60005473ffffffffffffffffffffffffffffffffffffffff163314610368576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b6040517f8f28397000000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8281166004830152831690638f283970906024015b600060405180830381600087803b1580156103d257600080fd5b505af11580156103e6573d6000803e3d6000fd5b505050505050565b60005473ffffffffffffffffffffffffffffffffffffffff16331461046f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b6040517f4f1ef28600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff841690634f1ef2869034906104c59086908690600401610981565b6000604051808303818588803b1580156104de57600080fd5b505af11580156104f2573d6000803e3d6000fd5b5050505050505050565b60005473ffffffffffffffffffffffffffffffffffffffff16331461057d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b6040517f3659cfe600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8281166004830152831690633659cfe6906024016103b8565b60005473ffffffffffffffffffffffffffffffffffffffff163314610652576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b73ffffffffffffffffffffffffffffffffffffffff81166106f5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f646472657373000000000000000000000000000000000000000000000000000060648201526084016102d2565b6106fe8161074d565b50565b60008060008373ffffffffffffffffffffffffffffffffffffffff166040516101ea907ff851a44000000000000000000000000000000000000000000000000000000000815260040190565b6000805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b73ffffffffffffffffffffffffffffffffffffffff811681146106fe57600080fd5b6000602082840312156107f657600080fd5b8135610801816107c2565b9392505050565b6000806040838503121561081b57600080fd5b8235610826816107c2565b91506020830135610836816107c2565b809150509250929050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b60008060006060848603121561088557600080fd5b8335610890816107c2565b925060208401356108a0816107c2565b9150604084013567ffffffffffffffff808211156108bd57600080fd5b818601915086601f8301126108d157600080fd5b8135818111156108e3576108e3610841565b604051601f82017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0908116603f0116810190838211818310171561092957610929610841565b8160405282815289602084870101111561094257600080fd5b8260208601602083013760006020848301015280955050505050509250925092565b60006020828403121561097657600080fd5b8151610801816107c2565b73ffffffffffffffffffffffffffffffffffffffff8316815260006020604081840152835180604085015260005b818110156109cb578581018301518582016060015282016109af565b818111156109dd576000606083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160600194935050505056fea2646970667358221220bd6c09ab03bfaf9ec60a4bf8cd98903cecb891974e17e2d76a3b2002c97eeb8964736f6c634300080a0033", + "deployedBytecode": "0x60806040526004361061007b5760003560e01c80639623609d1161004e5780639623609d1461012b57806399a88ec41461013e578063f2fde38b1461015e578063f3b7dead1461017e57600080fd5b8063204e1c7a14610080578063715018a6146100c95780637eff275e146100e05780638da5cb5b14610100575b600080fd5b34801561008c57600080fd5b506100a061009b3660046107e4565b61019e565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d557600080fd5b506100de610255565b005b3480156100ec57600080fd5b506100de6100fb366004610808565b6102e7565b34801561010c57600080fd5b5060005473ffffffffffffffffffffffffffffffffffffffff166100a0565b6100de610139366004610870565b6103ee565b34801561014a57600080fd5b506100de610159366004610808565b6104fc565b34801561016a57600080fd5b506100de6101793660046107e4565b6105d1565b34801561018a57600080fd5b506100a06101993660046107e4565b610701565b60008060008373ffffffffffffffffffffffffffffffffffffffff166040516101ea907f5c60da1b00000000000000000000000000000000000000000000000000000000815260040190565b600060405180830381855afa9150503d8060008114610225576040519150601f19603f3d011682016040523d82523d6000602084013e61022a565b606091505b50915091508161023957600080fd5b8080602001905181019061024d9190610964565b949350505050565b60005473ffffffffffffffffffffffffffffffffffffffff1633146102db576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064015b60405180910390fd5b6102e5600061074d565b565b60005473ffffffffffffffffffffffffffffffffffffffff163314610368576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b6040517f8f28397000000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8281166004830152831690638f283970906024015b600060405180830381600087803b1580156103d257600080fd5b505af11580156103e6573d6000803e3d6000fd5b505050505050565b60005473ffffffffffffffffffffffffffffffffffffffff16331461046f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b6040517f4f1ef28600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff841690634f1ef2869034906104c59086908690600401610981565b6000604051808303818588803b1580156104de57600080fd5b505af11580156104f2573d6000803e3d6000fd5b5050505050505050565b60005473ffffffffffffffffffffffffffffffffffffffff16331461057d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b6040517f3659cfe600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8281166004830152831690633659cfe6906024016103b8565b60005473ffffffffffffffffffffffffffffffffffffffff163314610652576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102d2565b73ffffffffffffffffffffffffffffffffffffffff81166106f5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f646472657373000000000000000000000000000000000000000000000000000060648201526084016102d2565b6106fe8161074d565b50565b60008060008373ffffffffffffffffffffffffffffffffffffffff166040516101ea907ff851a44000000000000000000000000000000000000000000000000000000000815260040190565b6000805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b73ffffffffffffffffffffffffffffffffffffffff811681146106fe57600080fd5b6000602082840312156107f657600080fd5b8135610801816107c2565b9392505050565b6000806040838503121561081b57600080fd5b8235610826816107c2565b91506020830135610836816107c2565b809150509250929050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b60008060006060848603121561088557600080fd5b8335610890816107c2565b925060208401356108a0816107c2565b9150604084013567ffffffffffffffff808211156108bd57600080fd5b818601915086601f8301126108d157600080fd5b8135818111156108e3576108e3610841565b604051601f82017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0908116603f0116810190838211818310171561092957610929610841565b8160405282815289602084870101111561094257600080fd5b8260208601602083013760006020848301015280955050505050509250925092565b60006020828403121561097657600080fd5b8151610801816107c2565b73ffffffffffffffffffffffffffffffffffffffff8316815260006020604081840152835180604085015260005b818110156109cb578581018301518582016060015282016109af565b818111156109dd576000606083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160600194935050505056fea2646970667358221220bd6c09ab03bfaf9ec60a4bf8cd98903cecb891974e17e2d76a3b2002c97eeb8964736f6c634300080a0033", + "devdoc": { + "details": "This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.", + "kind": "dev", + "methods": { + "changeProxyAdmin(address,address)": { + "details": "Changes the admin of `proxy` to `newAdmin`. Requirements: - This contract must be the current admin of `proxy`." + }, + "getProxyAdmin(address)": { + "details": "Returns the current admin of `proxy`. Requirements: - This contract must be the admin of `proxy`." + }, + "getProxyImplementation(address)": { + "details": "Returns the current implementation of `proxy`. Requirements: - This contract must be the admin of `proxy`." + }, + "owner()": { + "details": "Returns the address of the current owner." + }, + "renounceOwnership()": { + "details": "Leaves the contract without owner. It will not be possible to call `onlyOwner` functions anymore. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner." + }, + "transferOwnership(address)": { + "details": "Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner." + }, + "upgrade(address,address)": { + "details": "Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}. Requirements: - This contract must be the admin of `proxy`." + }, + "upgradeAndCall(address,address,bytes)": { + "details": "Upgrades `proxy` to `implementation` and calls a function on the new implementation. See {TransparentUpgradeableProxy-upgradeToAndCall}. Requirements: - This contract must be the admin of `proxy`." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 7, + "contract": "solc_0.8/openzeppelin/proxy/transparent/ProxyAdmin.sol:ProxyAdmin", + "label": "_owner", + "offset": 0, + "slot": "0", + "type": "t_address" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + } + } + } +} diff --git a/deployments/arbitrumsepolia/XVS.json b/deployments/arbitrumsepolia/XVS.json new file mode 100644 index 0000000..eea1988 --- /dev/null +++ b/deployments/arbitrumsepolia/XVS.json @@ -0,0 +1,1109 @@ +{ + "address": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user", + "type": "address" + } + ], + "name": "AccountBlacklisted", + "type": "error" + }, + { + "inputs": [], + "name": "AddressesMustDiffer", + "type": "error" + }, + { + "inputs": [], + "name": "MintLimitExceed", + "type": "error" + }, + { + "inputs": [], + "name": "MintedAmountExceed", + "type": "error" + }, + { + "inputs": [], + "name": "NewCapNotGreaterThanMintedTokens", + "type": "error" + }, + { + "inputs": [], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "owner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "value", + "type": "uint256" + } + ], + "name": "Approval", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "user", + "type": "address" + }, + { + "indexed": false, + "internalType": "bool", + "name": "value", + "type": "bool" + } + ], + "name": "BlacklistUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "minter", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "MintCapChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "minter", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newLimit", + "type": "uint256" + } + ], + "name": "MintLimitDecreased", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "minter", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newLimit", + "type": "uint256" + } + ], + "name": "MintLimitIncreased", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "source", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "destination", + "type": "address" + } + ], + "name": "MintedTokensMigrated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Paused", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "from", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "value", + "type": "uint256" + } + ], + "name": "Transfer", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Unpaused", + "type": "event" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "owner", + "type": "address" + }, + { + "internalType": "address", + "name": "spender", + "type": "address" + } + ], + "name": "allowance", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "approve", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "balanceOf", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "burn", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "decimals", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "internalType": "uint256", + "name": "subtractedValue", + "type": "uint256" + } + ], + "name": "decreaseAllowance", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "internalType": "uint256", + "name": "addedValue", + "type": "uint256" + } + ], + "name": "increaseAllowance", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user_", + "type": "address" + } + ], + "name": "isBlackListed", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "source_", + "type": "address" + }, + { + "internalType": "address", + "name": "destination_", + "type": "address" + } + ], + "name": "migrateMinterTokens", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "mint", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "name": "minterToCap", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "name": "minterToMintedAmount", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "name", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "paused", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newAccessControlAddress_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "minter_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "setMintCap", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "symbol", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "totalSupply", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "transfer", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "from", + "type": "address" + }, + { + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "transferFrom", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "unpause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user_", + "type": "address" + }, + { + "internalType": "bool", + "name": "value_", + "type": "bool" + } + ], + "name": "updateBlacklist", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ], + "transactionHash": "0xa4451e8b4ee611bccdbd94595874f92344f3c1be9ec4dc27759c713994b33746", + "receipt": { + "to": null, + "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", + "contractAddress": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "transactionIndex": 3, + "gasUsed": "1646166", + "logsBloom": "0x00000000000000000000000200000000000000000000000400800000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000200000000000020800000000000000000800000000000000000000000000000000400000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0xde62f7d261145afe999ab2b38c474a89bdd042a5a696a858d6ff4d3998259933", + "transactionHash": "0xa4451e8b4ee611bccdbd94595874f92344f3c1be9ec4dc27759c713994b33746", + "logs": [ + { + "transactionIndex": 3, + "blockNumber": 27104878, + "transactionHash": "0xa4451e8b4ee611bccdbd94595874f92344f3c1be9ec4dc27759c713994b33746", + "address": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "topics": [ + "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" + ], + "data": "0x", + "logIndex": 19, + "blockHash": "0xde62f7d261145afe999ab2b38c474a89bdd042a5a696a858d6ff4d3998259933" + } + ], + "blockNumber": 27104878, + "cumulativeGasUsed": "3274704", + "status": 1, + "byzantium": true + }, + "args": ["0xa36AD96441cB931D8dFEAAaC97D3FaB4B39E590F"], + "numDeployments": 1, + "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", + "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user\",\"type\":\"address\"}],\"name\":\"AccountBlacklisted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"AddressesMustDiffer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MintLimitExceed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MintedAmountExceed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NewCapNotGreaterThanMintedTokens\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"user\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"value\",\"type\":\"bool\"}],\"name\":\"BlacklistUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"MintCapChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newLimit\",\"type\":\"uint256\"}],\"name\":\"MintLimitDecreased\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newLimit\",\"type\":\"uint256\"}],\"name\":\"MintLimitIncreased\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"source\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"destination\",\"type\":\"address\"}],\"name\":\"MintedTokensMigrated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"burn\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"decimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"subtractedValue\",\"type\":\"uint256\"}],\"name\":\"decreaseAllowance\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"addedValue\",\"type\":\"uint256\"}],\"name\":\"increaseAllowance\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"}],\"name\":\"isBlackListed\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"source_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"destination_\",\"type\":\"address\"}],\"name\":\"migrateMinterTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"mint\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"minterToCap\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"minterToMintedAmount\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"name\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAccessControlAddress_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"minter_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"setMintCap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"symbol\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"unpause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"value_\",\"type\":\"bool\"}],\"name\":\"updateBlacklist\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"allowance(address,address)\":{\"details\":\"See {IERC20-allowance}.\"},\"approve(address,uint256)\":{\"details\":\"See {IERC20-approve}. NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on `transferFrom`. This is semantically equivalent to an infinite approval. Requirements: - `spender` cannot be the zero address.\"},\"balanceOf(address)\":{\"details\":\"See {IERC20-balanceOf}.\"},\"burn(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits MintLimitIncreased with new available limit.\",\"params\":{\"account_\":\"Address from which tokens be destroyed.\",\"amount_\":\"Amount of tokens to be destroyed.\"}},\"decimals()\":{\"details\":\"Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the default value returned by this function, unless it's overridden. NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}.\"},\"decreaseAllowance(address,uint256)\":{\"details\":\"Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`.\"},\"increaseAllowance(address,uint256)\":{\"details\":\"Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address.\"},\"isBlackListed(address)\":{\"params\":{\"user_\":\"Address of user to check blacklist status.\"},\"returns\":{\"_0\":\"bool status of blacklist.\"}},\"migrateMinterTokens(address,address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"MintLimitExceed is thrown when the minting limit exceeds the cap after migration.AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\",\"custom:event\":\"Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.Emits MintedTokensMigrated.\",\"params\":{\"destination_\":\"Minter address to migrate tokens to.\",\"source_\":\"Minter address to migrate tokens from.\"}},\"mint(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"MintLimitExceed is thrown when minting amount exceeds the maximum cap.\",\"custom:event\":\"Emits MintLimitDecreased with new available limit.\",\"params\":{\"account_\":\"Address to which tokens are assigned.\",\"amount_\":\"Amount of tokens to be assigned.\"}},\"name()\":{\"details\":\"Returns the name of the token.\"},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pause()\":{\"custom:access\":\"Controlled by AccessControlManager.\"},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"renounceOwnership()\":{\"details\":\"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.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only owner.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\",\"custom:event\":\"Emits NewAccessControlManager.\",\"details\":\"Admin function to set the access control address.\",\"params\":{\"newAccessControlAddress_\":\"New address for the access control.\"}},\"setMintCap(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits MintCapChanged.\",\"params\":{\"amount_\":\"Cap for the minter.\",\"minter_\":\"Minter address.\"}},\"symbol()\":{\"details\":\"Returns the symbol of the token, usually a shorter version of the name.\"},\"totalSupply()\":{\"details\":\"See {IERC20-totalSupply}.\"},\"transfer(address,uint256)\":{\"details\":\"See {IERC20-transfer}. Requirements: - `to` cannot be the zero address. - the caller must have a balance of at least `amount`.\"},\"transferFrom(address,address,uint256)\":{\"details\":\"See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated allowance. This is not required by the EIP. See the note at the beginning of {ERC20}. NOTE: Does not update the allowance if the current allowance is the maximum `uint256`. Requirements: - `from` and `to` cannot be the zero address. - `from` must have a balance of at least `amount`. - the caller must have allowance for ``from``'s tokens of at least `amount`.\"},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"unpause()\":{\"custom:access\":\"Controlled by AccessControlManager.\"},\"updateBlacklist(address,bool)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits BlacklistUpdated event.\",\"params\":{\"user_\":\"User address to be affected.\",\"value_\":\"Boolean to toggle value.\"}}},\"title\":\"XVS\",\"version\":1},\"userdoc\":{\"errors\":{\"AccountBlacklisted(address)\":[{\"notice\":\"This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\"}],\"AddressesMustDiffer()\":[{\"notice\":\"This error is used to indicate that the addresses must be different.\"}],\"MintLimitExceed()\":[{\"notice\":\"This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\"}],\"MintedAmountExceed()\":[{\"notice\":\"This error is used to indicate that the minter did not mint the required amount of tokens.\"}],\"NewCapNotGreaterThanMintedTokens()\":[{\"notice\":\"This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\"}],\"Unauthorized()\":[{\"notice\":\"This error is used to indicate that sender is not allowed to perform this action.\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"BlacklistUpdated(address,bool)\":{\"notice\":\"Emitted when the blacklist status of a user is updated.\"},\"MintCapChanged(address,uint256)\":{\"notice\":\"Emitted when the minting cap for a minter is changed.\"},\"MintLimitDecreased(address,uint256)\":{\"notice\":\"Emitted when the minting limit for a minter is decreased.\"},\"MintLimitIncreased(address,uint256)\":{\"notice\":\"Emitted when the minting limit for a minter is increased.\"},\"MintedTokensMigrated(address,address)\":{\"notice\":\"Emitted when all minted tokens are migrated from one minter to another.\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when the address of the access control manager of the contract is updated.\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Access control manager contract address.\"},\"burn(address,uint256)\":{\"notice\":\"Destroys `amount_` tokens from `account_`, reducing the total supply. Checks access and eligibility.\"},\"isBlackListed(address)\":{\"notice\":\"Returns the blacklist status of the address.\"},\"migrateMinterTokens(address,address)\":{\"notice\":\"Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\"},\"mint(address,uint256)\":{\"notice\":\"Creates `amount_` tokens and assigns them to `account_`, increasing the total supply. Checks access and eligibility.\"},\"minterToCap(address)\":{\"notice\":\"A mapping is used to keep track of the maximum amount a minter is permitted to mint.\"},\"minterToMintedAmount(address)\":{\"notice\":\"A Mapping used to keep track of the amount i.e already minted by minter.\"},\"pause()\":{\"notice\":\"Pauses Token\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of the access control manager of this contract.\"},\"setMintCap(address,uint256)\":{\"notice\":\"Sets the minting cap for minter.\"},\"unpause()\":{\"notice\":\"Resumes Token\"},\"updateBlacklist(address,bool)\":{\"notice\":\"Function to update blacklist.\"}},\"notice\":\"XVS contract serves as a customized ERC-20 token with additional minting and burning functionality. It also incorporates access control features provided by the \\\"TokenController\\\" contract to ensure proper governance and restrictions on minting and burning operations.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/token/XVS.sol\":\"XVS\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n _requireNotPaused();\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n _requirePaused();\\n _;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Throws if the contract is paused.\\n */\\n function _requireNotPaused() internal view virtual {\\n require(!paused(), \\\"Pausable: paused\\\");\\n }\\n\\n /**\\n * @dev Throws if the contract is not paused.\\n */\\n function _requirePaused() internal view virtual {\\n require(paused(), \\\"Pausable: not paused\\\");\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0x0849d93b16c9940beb286a7864ed02724b248b93e0d80ef6355af5ef15c64773\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/ERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./IERC20.sol\\\";\\nimport \\\"./extensions/IERC20Metadata.sol\\\";\\nimport \\\"../../utils/Context.sol\\\";\\n\\n/**\\n * @dev Implementation of the {IERC20} interface.\\n *\\n * This implementation is agnostic to the way tokens are created. This means\\n * that a supply mechanism has to be added in a derived contract using {_mint}.\\n * For a generic mechanism see {ERC20PresetMinterPauser}.\\n *\\n * TIP: For a detailed writeup see our guide\\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\\n * to implement supply mechanisms].\\n *\\n * The default value of {decimals} is 18. To change this, you should override\\n * this function so it returns a different value.\\n *\\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\\n * instead returning `false` on failure. This behavior is nonetheless\\n * conventional and does not conflict with the expectations of ERC20\\n * applications.\\n *\\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\\n * This allows applications to reconstruct the allowance for all accounts just\\n * by listening to said events. Other implementations of the EIP may not emit\\n * these events, as it isn't required by the specification.\\n *\\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\\n * functions have been added to mitigate the well-known issues around setting\\n * allowances. See {IERC20-approve}.\\n */\\ncontract ERC20 is Context, IERC20, IERC20Metadata {\\n mapping(address => uint256) private _balances;\\n\\n mapping(address => mapping(address => uint256)) private _allowances;\\n\\n uint256 private _totalSupply;\\n\\n string private _name;\\n string private _symbol;\\n\\n /**\\n * @dev Sets the values for {name} and {symbol}.\\n *\\n * All two of these values are immutable: they can only be set once during\\n * construction.\\n */\\n constructor(string memory name_, string memory symbol_) {\\n _name = name_;\\n _symbol = symbol_;\\n }\\n\\n /**\\n * @dev Returns the name of the token.\\n */\\n function name() public view virtual override returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @dev Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view virtual override returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @dev Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei. This is the default value returned by this function, unless\\n * it's overridden.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view virtual override returns (uint8) {\\n return 18;\\n }\\n\\n /**\\n * @dev See {IERC20-totalSupply}.\\n */\\n function totalSupply() public view virtual override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @dev See {IERC20-balanceOf}.\\n */\\n function balanceOf(address account) public view virtual override returns (uint256) {\\n return _balances[account];\\n }\\n\\n /**\\n * @dev See {IERC20-transfer}.\\n *\\n * Requirements:\\n *\\n * - `to` cannot be the zero address.\\n * - the caller must have a balance of at least `amount`.\\n */\\n function transfer(address to, uint256 amount) public virtual override returns (bool) {\\n address owner = _msgSender();\\n _transfer(owner, to, amount);\\n return true;\\n }\\n\\n /**\\n * @dev See {IERC20-allowance}.\\n */\\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\\n return _allowances[owner][spender];\\n }\\n\\n /**\\n * @dev See {IERC20-approve}.\\n *\\n * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\\n * `transferFrom`. This is semantically equivalent to an infinite approval.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n */\\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\\n address owner = _msgSender();\\n _approve(owner, spender, amount);\\n return true;\\n }\\n\\n /**\\n * @dev See {IERC20-transferFrom}.\\n *\\n * Emits an {Approval} event indicating the updated allowance. This is not\\n * required by the EIP. See the note at the beginning of {ERC20}.\\n *\\n * NOTE: Does not update the allowance if the current allowance\\n * is the maximum `uint256`.\\n *\\n * Requirements:\\n *\\n * - `from` and `to` cannot be the zero address.\\n * - `from` must have a balance of at least `amount`.\\n * - the caller must have allowance for ``from``'s tokens of at least\\n * `amount`.\\n */\\n function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\\n address spender = _msgSender();\\n _spendAllowance(from, spender, amount);\\n _transfer(from, to, amount);\\n return true;\\n }\\n\\n /**\\n * @dev Atomically increases the allowance granted to `spender` by the caller.\\n *\\n * This is an alternative to {approve} that can be used as a mitigation for\\n * problems described in {IERC20-approve}.\\n *\\n * Emits an {Approval} event indicating the updated allowance.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n */\\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\\n address owner = _msgSender();\\n _approve(owner, spender, allowance(owner, spender) + addedValue);\\n return true;\\n }\\n\\n /**\\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\\n *\\n * This is an alternative to {approve} that can be used as a mitigation for\\n * problems described in {IERC20-approve}.\\n *\\n * Emits an {Approval} event indicating the updated allowance.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `spender` must have allowance for the caller of at least\\n * `subtractedValue`.\\n */\\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\\n address owner = _msgSender();\\n uint256 currentAllowance = allowance(owner, spender);\\n require(currentAllowance >= subtractedValue, \\\"ERC20: decreased allowance below zero\\\");\\n unchecked {\\n _approve(owner, spender, currentAllowance - subtractedValue);\\n }\\n\\n return true;\\n }\\n\\n /**\\n * @dev Moves `amount` of tokens from `from` to `to`.\\n *\\n * This internal function is equivalent to {transfer}, and can be used to\\n * e.g. implement automatic token fees, slashing mechanisms, etc.\\n *\\n * Emits a {Transfer} event.\\n *\\n * Requirements:\\n *\\n * - `from` cannot be the zero address.\\n * - `to` cannot be the zero address.\\n * - `from` must have a balance of at least `amount`.\\n */\\n function _transfer(address from, address to, uint256 amount) internal virtual {\\n require(from != address(0), \\\"ERC20: transfer from the zero address\\\");\\n require(to != address(0), \\\"ERC20: transfer to the zero address\\\");\\n\\n _beforeTokenTransfer(from, to, amount);\\n\\n uint256 fromBalance = _balances[from];\\n require(fromBalance >= amount, \\\"ERC20: transfer amount exceeds balance\\\");\\n unchecked {\\n _balances[from] = fromBalance - amount;\\n // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\\n // decrementing then incrementing.\\n _balances[to] += amount;\\n }\\n\\n emit Transfer(from, to, amount);\\n\\n _afterTokenTransfer(from, to, amount);\\n }\\n\\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements:\\n *\\n * - `account` cannot be the zero address.\\n */\\n function _mint(address account, uint256 amount) internal virtual {\\n require(account != address(0), \\\"ERC20: mint to the zero address\\\");\\n\\n _beforeTokenTransfer(address(0), account, amount);\\n\\n _totalSupply += amount;\\n unchecked {\\n // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\\n _balances[account] += amount;\\n }\\n emit Transfer(address(0), account, amount);\\n\\n _afterTokenTransfer(address(0), account, amount);\\n }\\n\\n /**\\n * @dev Destroys `amount` tokens from `account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements:\\n *\\n * - `account` cannot be the zero address.\\n * - `account` must have at least `amount` tokens.\\n */\\n function _burn(address account, uint256 amount) internal virtual {\\n require(account != address(0), \\\"ERC20: burn from the zero address\\\");\\n\\n _beforeTokenTransfer(account, address(0), amount);\\n\\n uint256 accountBalance = _balances[account];\\n require(accountBalance >= amount, \\\"ERC20: burn amount exceeds balance\\\");\\n unchecked {\\n _balances[account] = accountBalance - amount;\\n // Overflow not possible: amount <= accountBalance <= totalSupply.\\n _totalSupply -= amount;\\n }\\n\\n emit Transfer(account, address(0), amount);\\n\\n _afterTokenTransfer(account, address(0), amount);\\n }\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\\n *\\n * This internal function is equivalent to `approve`, and can be used to\\n * e.g. set automatic allowances for certain subsystems, etc.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `owner` cannot be the zero address.\\n * - `spender` cannot be the zero address.\\n */\\n function _approve(address owner, address spender, uint256 amount) internal virtual {\\n require(owner != address(0), \\\"ERC20: approve from the zero address\\\");\\n require(spender != address(0), \\\"ERC20: approve to the zero address\\\");\\n\\n _allowances[owner][spender] = amount;\\n emit Approval(owner, spender, amount);\\n }\\n\\n /**\\n * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\\n *\\n * Does not update the allowance amount in case of infinite allowance.\\n * Revert if not enough allowance is available.\\n *\\n * Might emit an {Approval} event.\\n */\\n function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\\n uint256 currentAllowance = allowance(owner, spender);\\n if (currentAllowance != type(uint256).max) {\\n require(currentAllowance >= amount, \\\"ERC20: insufficient allowance\\\");\\n unchecked {\\n _approve(owner, spender, currentAllowance - amount);\\n }\\n }\\n }\\n\\n /**\\n * @dev Hook that is called before any transfer of tokens. This includes\\n * minting and burning.\\n *\\n * Calling conditions:\\n *\\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\\n * will be transferred to `to`.\\n * - when `from` is zero, `amount` tokens will be minted for `to`.\\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\\n * - `from` and `to` are never both zero.\\n *\\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\\n */\\n function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\\n\\n /**\\n * @dev Hook that is called after any transfer of tokens. This includes\\n * minting and burning.\\n *\\n * Calling conditions:\\n *\\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\\n * has been transferred to `to`.\\n * - when `from` is zero, `amount` tokens have been minted for `to`.\\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\\n * - `from` and `to` are never both zero.\\n *\\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\\n */\\n function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\\n}\\n\",\"keccak256\":\"0xa56ca923f70c1748830700250b19c61b70db9a683516dc5e216694a50445d99c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC20 standard.\\n *\\n * _Available since v4.1._\\n */\\ninterface IERC20Metadata is IERC20 {\\n /**\\n * @dev Returns the name of the token.\\n */\\n function name() external view returns (string memory);\\n\\n /**\\n * @dev Returns the symbol of the token.\\n */\\n function symbol() external view returns (string memory);\\n\\n /**\\n * @dev Returns the decimals places of the token.\\n */\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x8de418a5503946cabe331f35fe242d3201a73f67f77aaeb7110acb1f30423aca\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x8adbe291d659987faf4de606736227ad9d8e1a0e284a33a6ca12b30ab2a504b2\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/token/TokenController.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\nimport { IAccessControlManagerV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\\\";\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { Ownable } from \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\n\\n/**\\n * @title TokenController\\n * @author Venus\\n * @notice TokenController contract acts as a governance and access control mechanism,\\n * allowing the owner to manage minting restrictions and blacklist certain addresses to maintain control and security within the token ecosystem.\\n * It provides a flexible framework for token-related operations.\\n */\\n\\ncontract TokenController is Ownable, Pausable {\\n /**\\n * @notice Access control manager contract address.\\n */\\n address public accessControlManager;\\n /**\\n * @notice A Mapping used to keep track of the blacklist status of addresses.\\n */\\n mapping(address => bool) internal _blacklist;\\n /**\\n * @notice A mapping is used to keep track of the maximum amount a minter is permitted to mint.\\n */\\n mapping(address => uint256) public minterToCap;\\n /**\\n * @notice A Mapping used to keep track of the amount i.e already minted by minter.\\n */\\n mapping(address => uint256) public minterToMintedAmount;\\n\\n /**\\n * @notice Emitted when the blacklist status of a user is updated.\\n */\\n event BlacklistUpdated(address indexed user, bool value);\\n /**\\n * @notice Emitted when the minting limit for a minter is increased.\\n */\\n event MintLimitIncreased(address indexed minter, uint256 newLimit);\\n /**\\n * @notice Emitted when the minting limit for a minter is decreased.\\n */\\n event MintLimitDecreased(address indexed minter, uint256 newLimit);\\n /**\\n * @notice Emitted when the minting cap for a minter is changed.\\n */\\n event MintCapChanged(address indexed minter, uint256 amount);\\n /**\\n * @notice Emitted when the address of the access control manager of the contract is updated.\\n */\\n event NewAccessControlManager(address indexed oldAccessControlManager, address indexed newAccessControlManager);\\n /**\\n * @notice Emitted when all minted tokens are migrated from one minter to another.\\n */\\n event MintedTokensMigrated(address indexed source, address indexed destination);\\n\\n /**\\n * @notice This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\\n */\\n error MintLimitExceed();\\n /**\\n * @notice This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\\n */\\n error AccountBlacklisted(address user);\\n /**\\n * @notice This error is used to indicate that sender is not allowed to perform this action.\\n */\\n error Unauthorized();\\n /**\\n * @notice This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\\n */\\n error NewCapNotGreaterThanMintedTokens();\\n /**\\n * @notice This error is used to indicate that the addresses must be different.\\n */\\n error AddressesMustDiffer();\\n /**\\n * @notice This error is used to indicate that the minter did not mint the required amount of tokens.\\n */\\n error MintedAmountExceed();\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n * @custom:error ZeroAddressNotAllowed is thrown when accessControlManager contract address is zero.\\n */\\n constructor(address accessControlManager_) {\\n ensureNonzeroAddress(accessControlManager_);\\n accessControlManager = accessControlManager_;\\n }\\n\\n /**\\n * @notice Pauses Token\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function pause() external {\\n _ensureAllowed(\\\"pause()\\\");\\n _pause();\\n }\\n\\n /**\\n * @notice Resumes Token\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function unpause() external {\\n _ensureAllowed(\\\"unpause()\\\");\\n _unpause();\\n }\\n\\n /**\\n * @notice Function to update blacklist.\\n * @param user_ User address to be affected.\\n * @param value_ Boolean to toggle value.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits BlacklistUpdated event.\\n */\\n function updateBlacklist(address user_, bool value_) external {\\n _ensureAllowed(\\\"updateBlacklist(address,bool)\\\");\\n _blacklist[user_] = value_;\\n emit BlacklistUpdated(user_, value_);\\n }\\n\\n /**\\n * @notice Sets the minting cap for minter.\\n * @param minter_ Minter address.\\n * @param amount_ Cap for the minter.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintCapChanged.\\n */\\n function setMintCap(address minter_, uint256 amount_) external {\\n _ensureAllowed(\\\"setMintCap(address,uint256)\\\");\\n\\n if (amount_ < minterToMintedAmount[minter_]) {\\n revert NewCapNotGreaterThanMintedTokens();\\n }\\n\\n minterToCap[minter_] = amount_;\\n emit MintCapChanged(minter_, amount_);\\n }\\n\\n /**\\n * @notice Sets the address of the access control manager of this contract.\\n * @dev Admin function to set the access control address.\\n * @param newAccessControlAddress_ New address for the access control.\\n * @custom:access Only owner.\\n * @custom:event Emits NewAccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\\n */\\n function setAccessControlManager(address newAccessControlAddress_) external onlyOwner {\\n ensureNonzeroAddress(newAccessControlAddress_);\\n emit NewAccessControlManager(accessControlManager, newAccessControlAddress_);\\n accessControlManager = newAccessControlAddress_;\\n }\\n\\n /**\\n * @notice Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\\n * @param source_ Minter address to migrate tokens from.\\n * @param destination_ Minter address to migrate tokens to.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error MintLimitExceed is thrown when the minting limit exceeds the cap after migration.\\n * @custom:error AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\\n * @custom:event Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.\\n * @custom:event Emits MintedTokensMigrated.\\n */\\n function migrateMinterTokens(address source_, address destination_) external {\\n _ensureAllowed(\\\"migrateMinterTokens(address,address)\\\");\\n\\n if (source_ == destination_) {\\n revert AddressesMustDiffer();\\n }\\n\\n uint256 sourceCap = minterToCap[source_];\\n uint256 destinationCap = minterToCap[destination_];\\n\\n uint256 sourceMinted = minterToMintedAmount[source_];\\n uint256 destinationMinted = minterToMintedAmount[destination_];\\n uint256 newDestinationMinted = destinationMinted + sourceMinted;\\n\\n if (newDestinationMinted > destinationCap) {\\n revert MintLimitExceed();\\n }\\n\\n minterToMintedAmount[source_] = 0;\\n minterToMintedAmount[destination_] = newDestinationMinted;\\n uint256 availableLimit;\\n unchecked {\\n availableLimit = destinationCap - newDestinationMinted;\\n }\\n\\n emit MintLimitDecreased(destination_, availableLimit);\\n emit MintLimitIncreased(source_, sourceCap);\\n emit MintedTokensMigrated(source_, destination_);\\n }\\n\\n /**\\n * @notice Returns the blacklist status of the address.\\n * @param user_ Address of user to check blacklist status.\\n * @return bool status of blacklist.\\n */\\n function isBlackListed(address user_) external view returns (bool) {\\n return _blacklist[user_];\\n }\\n\\n /**\\n * @dev Checks the minter cap and eligibility of receiver to receive tokens.\\n * @param from_ Minter address.\\n * @param to_ Receiver address.\\n * @param amount_ Amount to be mint.\\n * @custom:error MintLimitExceed is thrown when minting limit exceeds the cap.\\n * @custom:event Emits MintLimitDecreased with minter address and available limits.\\n */\\n function _isEligibleToMint(address from_, address to_, uint256 amount_) internal {\\n uint256 mintingCap = minterToCap[from_];\\n uint256 totalMintedOld = minterToMintedAmount[from_];\\n uint256 totalMintedNew = totalMintedOld + amount_;\\n\\n if (totalMintedNew > mintingCap) {\\n revert MintLimitExceed();\\n }\\n minterToMintedAmount[from_] = totalMintedNew;\\n uint256 availableLimit;\\n unchecked {\\n availableLimit = mintingCap - totalMintedNew;\\n }\\n emit MintLimitDecreased(from_, availableLimit);\\n }\\n\\n /**\\n * @dev This is post hook of burn function, increases minting limit of the minter.\\n * @param from_ Minter address.\\n * @param amount_ Amount burned.\\n * @custom:error MintedAmountExceed is thrown when `amount_` is greater than the tokens minted by `from_`.\\n * @custom:event Emits MintLimitIncreased with minter address and availabe limit.\\n */\\n function _increaseMintLimit(address from_, uint256 amount_) internal {\\n uint256 totalMintedOld = minterToMintedAmount[from_];\\n\\n if (totalMintedOld < amount_) {\\n revert MintedAmountExceed();\\n }\\n\\n uint256 totalMintedNew;\\n unchecked {\\n totalMintedNew = totalMintedOld - amount_;\\n }\\n minterToMintedAmount[from_] = totalMintedNew;\\n uint256 availableLimit = minterToCap[from_] - totalMintedNew;\\n emit MintLimitIncreased(from_, availableLimit);\\n }\\n\\n /**\\n * @dev Checks the caller is allowed to call the specified fuction.\\n * @param functionSig_ Function signatureon which access is to be checked.\\n * @custom:error Unauthorized, thrown when unauthorised user try to access function.\\n */\\n function _ensureAllowed(string memory functionSig_) internal view {\\n if (!IAccessControlManagerV8(accessControlManager).isAllowedToCall(msg.sender, functionSig_)) {\\n revert Unauthorized();\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc17ede791bb2160af4c2741f0d80a7340ab8352cb32581beb1d05a2a6a24ac71\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/token/XVS.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { ERC20 } from \\\"@openzeppelin/contracts/token/ERC20/ERC20.sol\\\";\\n\\nimport { TokenController } from \\\"./TokenController.sol\\\";\\n\\n/**\\n * @title XVS\\n * @author Venus\\n * @notice XVS contract serves as a customized ERC-20 token with additional minting and burning functionality.\\n * It also incorporates access control features provided by the \\\"TokenController\\\" contract to ensure proper governance and restrictions on minting and burning operations.\\n */\\n\\ncontract XVS is ERC20, TokenController {\\n constructor(address accessControlManager_) ERC20(\\\"Venus XVS\\\", \\\"XVS\\\") TokenController(accessControlManager_) {}\\n\\n /**\\n * @notice Creates `amount_` tokens and assigns them to `account_`, increasing\\n * the total supply. Checks access and eligibility.\\n * @param account_ Address to which tokens are assigned.\\n * @param amount_ Amount of tokens to be assigned.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintLimitDecreased with new available limit.\\n * @custom:error MintLimitExceed is thrown when minting amount exceeds the maximum cap.\\n */\\n function mint(address account_, uint256 amount_) external whenNotPaused {\\n _ensureAllowed(\\\"mint(address,uint256)\\\");\\n _isEligibleToMint(msg.sender, account_, amount_);\\n _mint(account_, amount_);\\n }\\n\\n /**\\n * @notice Destroys `amount_` tokens from `account_`, reducing the\\n * total supply. Checks access and eligibility.\\n * @param account_ Address from which tokens be destroyed.\\n * @param amount_ Amount of tokens to be destroyed.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintLimitIncreased with new available limit.\\n */\\n function burn(address account_, uint256 amount_) external whenNotPaused {\\n _ensureAllowed(\\\"burn(address,uint256)\\\");\\n _burn(account_, amount_);\\n _increaseMintLimit(msg.sender, amount_);\\n }\\n\\n /**\\n * @notice Hook that is called before any transfer of tokens. This includes\\n * minting and burning.\\n * @param from_ Address of account from which tokens are to be transferred.\\n * @param to_ Address of the account to which tokens are to be transferred.\\n * @param amount_ The amount of tokens to be transferred.\\n * @custom:error AccountBlacklisted is thrown when either `from` or `to` address is blacklisted.\\n */\\n function _beforeTokenTransfer(address from_, address to_, uint256 amount_) internal override whenNotPaused {\\n if (_blacklist[to_]) {\\n revert AccountBlacklisted(to_);\\n }\\n if (_blacklist[from_]) {\\n revert AccountBlacklisted(from_);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xf26fd5d1197124598105b0b2c6d3e260cb7d3e73ba07ad9dcf81f5c027075962\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x60806040523480156200001157600080fd5b50604051620019e4380380620019e483398101604081905262000034916200021b565b604080518082018252600981526856656e75732058565360b81b6020808301918252835180850190945260038085526258565360e81b91850191909152825185949262000082929162000175565b5080516200009890600490602084019062000175565b505050620000b5620000af620000f460201b60201c565b620000f8565b6005805460ff60a01b19169055620000cd816200014a565b600680546001600160a01b0319166001600160a01b03929092169190911790555062000289565b3390565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6001600160a01b03811662000172576040516342bcdf7f60e11b815260040160405180910390fd5b50565b82805462000183906200024d565b90600052602060002090601f016020900481019282620001a75760008555620001f2565b82601f10620001c257805160ff1916838001178555620001f2565b82800160010185558215620001f2579182015b82811115620001f2578251825591602001919060010190620001d5565b506200020092915062000204565b5090565b5b8082111562000200576000815560010162000205565b6000602082840312156200022e57600080fd5b81516001600160a01b03811681146200024657600080fd5b9392505050565b600181811c908216806200026257607f821691505b6020821081036200028357634e487b7160e01b600052602260045260246000fd5b50919050565b61174b80620002996000396000f3fe608060405234801561001057600080fd5b50600436106101a95760003560e01c80637b517334116100f9578063a9059cbb11610097578063d89e2dac11610071578063d89e2dac14610390578063dd62ed3e146103a3578063e47d6060146103b6578063f2fde38b146103e257600080fd5b8063a9059cbb14610357578063b4a0bdf31461036a578063c06abe771461037d57600080fd5b80639155e083116100d35780639155e0831461031657806395d89b41146103295780639dc29fac14610331578063a457c2d71461034457600080fd5b80637b517334146102c95780638456cb59146102e95780638da5cb5b146102f157600080fd5b8063391efe121161016657806340c10f191161014057806340c10f19146102735780635c975abb1461028657806370a0823114610298578063715018a6146102c157600080fd5b8063391efe121461023857806339509351146102585780633f4ba83a1461026b57600080fd5b806306fdde03146101ae578063095ea7b3146101cc5780630e32cb86146101ef57806318160ddd1461020457806323b872dd14610216578063313ce56714610229575b600080fd5b6101b66103f5565b6040516101c391906114fa565b60405180910390f35b6101df6101da366004611530565b610487565b60405190151581526020016101c3565b6102026101fd36600461155a565b61049f565b005b6002545b6040519081526020016101c3565b6101df610224366004611575565b61050c565b604051601281526020016101c3565b61020861024636600461155a565b60086020526000908152604090205481565b6101df610266366004611530565b610530565b610202610552565b610202610281366004611530565b610586565b600554600160a01b900460ff166101df565b6102086102a636600461155a565b6001600160a01b031660009081526020819052604090205490565b6102026105dd565b6102086102d736600461155a565b60096020526000908152604090205481565b6102026105ef565b6005546001600160a01b03165b6040516001600160a01b0390911681526020016101c3565b6102026103243660046115bf565b61061f565b6101b66106bd565b61020261033f366004611530565b6106cc565b6101df610352366004611530565b61071e565b6101df610365366004611530565b61079e565b6006546102fe906001600160a01b031681565b61020261038b366004611530565b6107ac565b61020261039e3660046115f6565b610870565b6102086103b13660046115f6565b610a18565b6101df6103c436600461155a565b6001600160a01b031660009081526007602052604090205460ff1690565b6102026103f036600461155a565b610a43565b60606003805461040490611629565b80601f016020809104026020016040519081016040528092919081815260200182805461043090611629565b801561047d5780601f106104525761010080835404028352916020019161047d565b820191906000526020600020905b81548152906001019060200180831161046057829003601f168201915b5050505050905090565b600033610495818585610abc565b5060019392505050565b6104a7610be1565b6104b081610c3b565b6006546040516001600160a01b038084169216907f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa090600090a3600680546001600160a01b0319166001600160a01b0392909216919091179055565b60003361051a858285610c62565b610525858585610cdc565b506001949350505050565b6000336104958185856105438383610a18565b61054d9190611679565b610abc565b61057c60405180604001604052806009815260200168756e7061757365282960b81b815250610e8b565b610584610f1a565b565b61058e610f6f565b6105c4604051806040016040528060158152602001746d696e7428616464726573732c75696e743235362960581b815250610e8b565b6105cf338383610fbc565b6105d98282611072565b5050565b6105e5610be1565b610584600061113d565b610617604051806040016040528060078152602001667061757365282960c81b815250610e8b565b61058461118f565b61065d6040518060400160405280601d81526020017f757064617465426c61636b6c69737428616464726573732c626f6f6c29000000815250610e8b565b6001600160a01b038216600081815260076020908152604091829020805460ff191685151590811790915591519182527f6a12b3df6cba4203bd7fd06b816789f87de8c594299aed5717ae070fac781bac91015b60405180910390a25050565b60606004805461040490611629565b6106d4610f6f565b61070a604051806040016040528060158152602001746275726e28616464726573732c75696e743235362960581b815250610e8b565b61071482826111d2565b6105d9338261130d565b6000338161072c8286610a18565b9050838110156107915760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6105258286868403610abc565b600033610495818585610cdc565b6107ea6040518060400160405280601b81526020017f7365744d696e7443617028616464726573732c75696e74323536290000000000815250610e8b565b6001600160a01b0382166000908152600960205260409020548110156108235760405163ce89973d60e01b815260040160405180910390fd5b6001600160a01b03821660008181526008602052604090819020839055517f01a85f4ecff52e70907e25b863010bca98a9458d9f2fe9b3efb4c47d197e6448906106b19084815260200190565b6108916040518060600160405280602481526020016116f260249139610e8b565b806001600160a01b0316826001600160a01b0316036108c3576040516380ae98f560e01b815260040160405180910390fd5b6001600160a01b038083166000818152600860209081526040808320549486168084528184205494845260099092528083205491835282205490916109088383611679565b90508381111561092b57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038781166000908152600960209081526040808320839055928916808352918390208490559151838703808252927fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61910160405180910390a2876001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb876040516109c691815260200190565b60405180910390a2866001600160a01b0316886001600160a01b03167f63ce671e4a37975f0a9e340f6f72320c617a5f728b83e3860b03aa847dc26ebb60405160405180910390a35050505050505050565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b610a4b610be1565b6001600160a01b038116610ab05760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610788565b610ab98161113d565b50565b6001600160a01b038316610b1e5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610788565b6001600160a01b038216610b7f5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610788565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6005546001600160a01b031633146105845760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610788565b6001600160a01b038116610ab9576040516342bcdf7f60e11b815260040160405180910390fd5b6000610c6e8484610a18565b90506000198114610cd65781811015610cc95760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610788565b610cd68484848403610abc565b50505050565b6001600160a01b038316610d405760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610788565b6001600160a01b038216610da25760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610788565b610dad8383836113cb565b6001600160a01b03831660009081526020819052604090205481811015610e255760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610788565b6001600160a01b03848116600081815260208181526040808320878703905593871680835291849020805487019055925185815290927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3610cd6565b6006546040516318c5e8ab60e01b81526001600160a01b03909116906318c5e8ab90610ebd9033908590600401611691565b602060405180830381865afa158015610eda573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610efe91906116bd565b610ab9576040516282b42960e81b815260040160405180910390fd5b610f2261145d565b6005805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600554600160a01b900460ff16156105845760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610788565b6001600160a01b03831660009081526008602090815260408083205460099092528220549091610fec8483611679565b90508281111561100f57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038616600081815260096020526040908190208390555182850391907fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61906110619084815260200190565b60405180910390a250505050505050565b6001600160a01b0382166110c85760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610788565b6110d4600083836113cb565b80600260008282546110e69190611679565b90915550506001600160a01b038216600081815260208181526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b611197610f6f565b6005805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f523390565b6001600160a01b0382166112325760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610788565b61123e826000836113cb565b6001600160a01b038216600090815260208190526040902054818110156112b25760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610788565b6001600160a01b0383166000818152602081815260408083208686039055600280548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9101610bd4565b505050565b6001600160a01b03821660009081526009602052604090205481811015611347576040516348af2f2960e11b815260040160405180910390fd5b6001600160a01b038316600090815260096020908152604080832085850390819055600890925282205490919061137f9083906116da565b9050846001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb826040516113bc91815260200190565b60405180910390a25050505050565b6113d3610f6f565b6001600160a01b03821660009081526007602052604090205460ff16156114185760405163571f7b4960e01b81526001600160a01b0383166004820152602401610788565b6001600160a01b03831660009081526007602052604090205460ff16156113085760405163571f7b4960e01b81526001600160a01b0384166004820152602401610788565b600554600160a01b900460ff166105845760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610788565b6000815180845260005b818110156114d3576020818501810151868301820152016114b7565b818111156114e5576000602083870101525b50601f01601f19169290920160200192915050565b60208152600061150d60208301846114ad565b9392505050565b80356001600160a01b038116811461152b57600080fd5b919050565b6000806040838503121561154357600080fd5b61154c83611514565b946020939093013593505050565b60006020828403121561156c57600080fd5b61150d82611514565b60008060006060848603121561158a57600080fd5b61159384611514565b92506115a160208501611514565b9150604084013590509250925092565b8015158114610ab957600080fd5b600080604083850312156115d257600080fd5b6115db83611514565b915060208301356115eb816115b1565b809150509250929050565b6000806040838503121561160957600080fd5b61161283611514565b915061162060208401611514565b90509250929050565b600181811c9082168061163d57607f821691505b60208210810361165d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b6000821982111561168c5761168c611663565b500190565b6001600160a01b03831681526040602082018190526000906116b5908301846114ad565b949350505050565b6000602082840312156116cf57600080fd5b815161150d816115b1565b6000828210156116ec576116ec611663565b50039056fe6d6967726174654d696e746572546f6b656e7328616464726573732c6164647265737329a26469706673582212202dd502ad7f111f919097342862e006098fd7d7236fbb113e5b8a2648ff94916664736f6c634300080d0033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106101a95760003560e01c80637b517334116100f9578063a9059cbb11610097578063d89e2dac11610071578063d89e2dac14610390578063dd62ed3e146103a3578063e47d6060146103b6578063f2fde38b146103e257600080fd5b8063a9059cbb14610357578063b4a0bdf31461036a578063c06abe771461037d57600080fd5b80639155e083116100d35780639155e0831461031657806395d89b41146103295780639dc29fac14610331578063a457c2d71461034457600080fd5b80637b517334146102c95780638456cb59146102e95780638da5cb5b146102f157600080fd5b8063391efe121161016657806340c10f191161014057806340c10f19146102735780635c975abb1461028657806370a0823114610298578063715018a6146102c157600080fd5b8063391efe121461023857806339509351146102585780633f4ba83a1461026b57600080fd5b806306fdde03146101ae578063095ea7b3146101cc5780630e32cb86146101ef57806318160ddd1461020457806323b872dd14610216578063313ce56714610229575b600080fd5b6101b66103f5565b6040516101c391906114fa565b60405180910390f35b6101df6101da366004611530565b610487565b60405190151581526020016101c3565b6102026101fd36600461155a565b61049f565b005b6002545b6040519081526020016101c3565b6101df610224366004611575565b61050c565b604051601281526020016101c3565b61020861024636600461155a565b60086020526000908152604090205481565b6101df610266366004611530565b610530565b610202610552565b610202610281366004611530565b610586565b600554600160a01b900460ff166101df565b6102086102a636600461155a565b6001600160a01b031660009081526020819052604090205490565b6102026105dd565b6102086102d736600461155a565b60096020526000908152604090205481565b6102026105ef565b6005546001600160a01b03165b6040516001600160a01b0390911681526020016101c3565b6102026103243660046115bf565b61061f565b6101b66106bd565b61020261033f366004611530565b6106cc565b6101df610352366004611530565b61071e565b6101df610365366004611530565b61079e565b6006546102fe906001600160a01b031681565b61020261038b366004611530565b6107ac565b61020261039e3660046115f6565b610870565b6102086103b13660046115f6565b610a18565b6101df6103c436600461155a565b6001600160a01b031660009081526007602052604090205460ff1690565b6102026103f036600461155a565b610a43565b60606003805461040490611629565b80601f016020809104026020016040519081016040528092919081815260200182805461043090611629565b801561047d5780601f106104525761010080835404028352916020019161047d565b820191906000526020600020905b81548152906001019060200180831161046057829003601f168201915b5050505050905090565b600033610495818585610abc565b5060019392505050565b6104a7610be1565b6104b081610c3b565b6006546040516001600160a01b038084169216907f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa090600090a3600680546001600160a01b0319166001600160a01b0392909216919091179055565b60003361051a858285610c62565b610525858585610cdc565b506001949350505050565b6000336104958185856105438383610a18565b61054d9190611679565b610abc565b61057c60405180604001604052806009815260200168756e7061757365282960b81b815250610e8b565b610584610f1a565b565b61058e610f6f565b6105c4604051806040016040528060158152602001746d696e7428616464726573732c75696e743235362960581b815250610e8b565b6105cf338383610fbc565b6105d98282611072565b5050565b6105e5610be1565b610584600061113d565b610617604051806040016040528060078152602001667061757365282960c81b815250610e8b565b61058461118f565b61065d6040518060400160405280601d81526020017f757064617465426c61636b6c69737428616464726573732c626f6f6c29000000815250610e8b565b6001600160a01b038216600081815260076020908152604091829020805460ff191685151590811790915591519182527f6a12b3df6cba4203bd7fd06b816789f87de8c594299aed5717ae070fac781bac91015b60405180910390a25050565b60606004805461040490611629565b6106d4610f6f565b61070a604051806040016040528060158152602001746275726e28616464726573732c75696e743235362960581b815250610e8b565b61071482826111d2565b6105d9338261130d565b6000338161072c8286610a18565b9050838110156107915760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6105258286868403610abc565b600033610495818585610cdc565b6107ea6040518060400160405280601b81526020017f7365744d696e7443617028616464726573732c75696e74323536290000000000815250610e8b565b6001600160a01b0382166000908152600960205260409020548110156108235760405163ce89973d60e01b815260040160405180910390fd5b6001600160a01b03821660008181526008602052604090819020839055517f01a85f4ecff52e70907e25b863010bca98a9458d9f2fe9b3efb4c47d197e6448906106b19084815260200190565b6108916040518060600160405280602481526020016116f260249139610e8b565b806001600160a01b0316826001600160a01b0316036108c3576040516380ae98f560e01b815260040160405180910390fd5b6001600160a01b038083166000818152600860209081526040808320549486168084528184205494845260099092528083205491835282205490916109088383611679565b90508381111561092b57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038781166000908152600960209081526040808320839055928916808352918390208490559151838703808252927fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61910160405180910390a2876001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb876040516109c691815260200190565b60405180910390a2866001600160a01b0316886001600160a01b03167f63ce671e4a37975f0a9e340f6f72320c617a5f728b83e3860b03aa847dc26ebb60405160405180910390a35050505050505050565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b610a4b610be1565b6001600160a01b038116610ab05760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610788565b610ab98161113d565b50565b6001600160a01b038316610b1e5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610788565b6001600160a01b038216610b7f5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610788565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6005546001600160a01b031633146105845760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610788565b6001600160a01b038116610ab9576040516342bcdf7f60e11b815260040160405180910390fd5b6000610c6e8484610a18565b90506000198114610cd65781811015610cc95760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610788565b610cd68484848403610abc565b50505050565b6001600160a01b038316610d405760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610788565b6001600160a01b038216610da25760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610788565b610dad8383836113cb565b6001600160a01b03831660009081526020819052604090205481811015610e255760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610788565b6001600160a01b03848116600081815260208181526040808320878703905593871680835291849020805487019055925185815290927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3610cd6565b6006546040516318c5e8ab60e01b81526001600160a01b03909116906318c5e8ab90610ebd9033908590600401611691565b602060405180830381865afa158015610eda573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610efe91906116bd565b610ab9576040516282b42960e81b815260040160405180910390fd5b610f2261145d565b6005805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600554600160a01b900460ff16156105845760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610788565b6001600160a01b03831660009081526008602090815260408083205460099092528220549091610fec8483611679565b90508281111561100f57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038616600081815260096020526040908190208390555182850391907fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61906110619084815260200190565b60405180910390a250505050505050565b6001600160a01b0382166110c85760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610788565b6110d4600083836113cb565b80600260008282546110e69190611679565b90915550506001600160a01b038216600081815260208181526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b611197610f6f565b6005805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f523390565b6001600160a01b0382166112325760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610788565b61123e826000836113cb565b6001600160a01b038216600090815260208190526040902054818110156112b25760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610788565b6001600160a01b0383166000818152602081815260408083208686039055600280548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9101610bd4565b505050565b6001600160a01b03821660009081526009602052604090205481811015611347576040516348af2f2960e11b815260040160405180910390fd5b6001600160a01b038316600090815260096020908152604080832085850390819055600890925282205490919061137f9083906116da565b9050846001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb826040516113bc91815260200190565b60405180910390a25050505050565b6113d3610f6f565b6001600160a01b03821660009081526007602052604090205460ff16156114185760405163571f7b4960e01b81526001600160a01b0383166004820152602401610788565b6001600160a01b03831660009081526007602052604090205460ff16156113085760405163571f7b4960e01b81526001600160a01b0384166004820152602401610788565b600554600160a01b900460ff166105845760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610788565b6000815180845260005b818110156114d3576020818501810151868301820152016114b7565b818111156114e5576000602083870101525b50601f01601f19169290920160200192915050565b60208152600061150d60208301846114ad565b9392505050565b80356001600160a01b038116811461152b57600080fd5b919050565b6000806040838503121561154357600080fd5b61154c83611514565b946020939093013593505050565b60006020828403121561156c57600080fd5b61150d82611514565b60008060006060848603121561158a57600080fd5b61159384611514565b92506115a160208501611514565b9150604084013590509250925092565b8015158114610ab957600080fd5b600080604083850312156115d257600080fd5b6115db83611514565b915060208301356115eb816115b1565b809150509250929050565b6000806040838503121561160957600080fd5b61161283611514565b915061162060208401611514565b90509250929050565b600181811c9082168061163d57607f821691505b60208210810361165d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b6000821982111561168c5761168c611663565b500190565b6001600160a01b03831681526040602082018190526000906116b5908301846114ad565b949350505050565b6000602082840312156116cf57600080fd5b815161150d816115b1565b6000828210156116ec576116ec611663565b50039056fe6d6967726174654d696e746572546f6b656e7328616464726573732c6164647265737329a26469706673582212202dd502ad7f111f919097342862e006098fd7d7236fbb113e5b8a2648ff94916664736f6c634300080d0033", + "devdoc": { + "author": "Venus", + "kind": "dev", + "methods": { + "allowance(address,address)": { + "details": "See {IERC20-allowance}." + }, + "approve(address,uint256)": { + "details": "See {IERC20-approve}. NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on `transferFrom`. This is semantically equivalent to an infinite approval. Requirements: - `spender` cannot be the zero address." + }, + "balanceOf(address)": { + "details": "See {IERC20-balanceOf}." + }, + "burn(address,uint256)": { + "custom:access": "Controlled by AccessControlManager.", + "custom:event": "Emits MintLimitIncreased with new available limit.", + "params": { + "account_": "Address from which tokens be destroyed.", + "amount_": "Amount of tokens to be destroyed." + } + }, + "decimals()": { + "details": "Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the default value returned by this function, unless it's overridden. NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}." + }, + "decreaseAllowance(address,uint256)": { + "details": "Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`." + }, + "increaseAllowance(address,uint256)": { + "details": "Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address." + }, + "isBlackListed(address)": { + "params": { + "user_": "Address of user to check blacklist status." + }, + "returns": { + "_0": "bool status of blacklist." + } + }, + "migrateMinterTokens(address,address)": { + "custom:access": "Controlled by AccessControlManager.", + "custom:error": "MintLimitExceed is thrown when the minting limit exceeds the cap after migration.AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.", + "custom:event": "Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.Emits MintedTokensMigrated.", + "params": { + "destination_": "Minter address to migrate tokens to.", + "source_": "Minter address to migrate tokens from." + } + }, + "mint(address,uint256)": { + "custom:access": "Controlled by AccessControlManager.", + "custom:error": "MintLimitExceed is thrown when minting amount exceeds the maximum cap.", + "custom:event": "Emits MintLimitDecreased with new available limit.", + "params": { + "account_": "Address to which tokens are assigned.", + "amount_": "Amount of tokens to be assigned." + } + }, + "name()": { + "details": "Returns the name of the token." + }, + "owner()": { + "details": "Returns the address of the current owner." + }, + "pause()": { + "custom:access": "Controlled by AccessControlManager." + }, + "paused()": { + "details": "Returns true if the contract is paused, and false otherwise." + }, + "renounceOwnership()": { + "details": "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." + }, + "setAccessControlManager(address)": { + "custom:access": "Only owner.", + "custom:error": "ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.", + "custom:event": "Emits NewAccessControlManager.", + "details": "Admin function to set the access control address.", + "params": { + "newAccessControlAddress_": "New address for the access control." + } + }, + "setMintCap(address,uint256)": { + "custom:access": "Controlled by AccessControlManager.", + "custom:event": "Emits MintCapChanged.", + "params": { + "amount_": "Cap for the minter.", + "minter_": "Minter address." + } + }, + "symbol()": { + "details": "Returns the symbol of the token, usually a shorter version of the name." + }, + "totalSupply()": { + "details": "See {IERC20-totalSupply}." + }, + "transfer(address,uint256)": { + "details": "See {IERC20-transfer}. Requirements: - `to` cannot be the zero address. - the caller must have a balance of at least `amount`." + }, + "transferFrom(address,address,uint256)": { + "details": "See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated allowance. This is not required by the EIP. See the note at the beginning of {ERC20}. NOTE: Does not update the allowance if the current allowance is the maximum `uint256`. Requirements: - `from` and `to` cannot be the zero address. - `from` must have a balance of at least `amount`. - the caller must have allowance for ``from``'s tokens of at least `amount`." + }, + "transferOwnership(address)": { + "details": "Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner." + }, + "unpause()": { + "custom:access": "Controlled by AccessControlManager." + }, + "updateBlacklist(address,bool)": { + "custom:access": "Controlled by AccessControlManager.", + "custom:event": "Emits BlacklistUpdated event.", + "params": { + "user_": "User address to be affected.", + "value_": "Boolean to toggle value." + } + } + }, + "title": "XVS", + "version": 1 + }, + "userdoc": { + "errors": { + "AccountBlacklisted(address)": [ + { + "notice": "This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address." + } + ], + "AddressesMustDiffer()": [ + { + "notice": "This error is used to indicate that the addresses must be different." + } + ], + "MintLimitExceed()": [ + { + "notice": "This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap." + } + ], + "MintedAmountExceed()": [ + { + "notice": "This error is used to indicate that the minter did not mint the required amount of tokens." + } + ], + "NewCapNotGreaterThanMintedTokens()": [ + { + "notice": "This error is used to indicate that the new cap is greater than the previously minted tokens for the minter." + } + ], + "Unauthorized()": [ + { + "notice": "This error is used to indicate that sender is not allowed to perform this action." + } + ], + "ZeroAddressNotAllowed()": [ + { + "notice": "Thrown if the supplied address is a zero address where it is not allowed" + } + ] + }, + "events": { + "BlacklistUpdated(address,bool)": { + "notice": "Emitted when the blacklist status of a user is updated." + }, + "MintCapChanged(address,uint256)": { + "notice": "Emitted when the minting cap for a minter is changed." + }, + "MintLimitDecreased(address,uint256)": { + "notice": "Emitted when the minting limit for a minter is decreased." + }, + "MintLimitIncreased(address,uint256)": { + "notice": "Emitted when the minting limit for a minter is increased." + }, + "MintedTokensMigrated(address,address)": { + "notice": "Emitted when all minted tokens are migrated from one minter to another." + }, + "NewAccessControlManager(address,address)": { + "notice": "Emitted when the address of the access control manager of the contract is updated." + } + }, + "kind": "user", + "methods": { + "accessControlManager()": { + "notice": "Access control manager contract address." + }, + "burn(address,uint256)": { + "notice": "Destroys `amount_` tokens from `account_`, reducing the total supply. Checks access and eligibility." + }, + "isBlackListed(address)": { + "notice": "Returns the blacklist status of the address." + }, + "migrateMinterTokens(address,address)": { + "notice": "Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge." + }, + "mint(address,uint256)": { + "notice": "Creates `amount_` tokens and assigns them to `account_`, increasing the total supply. Checks access and eligibility." + }, + "minterToCap(address)": { + "notice": "A mapping is used to keep track of the maximum amount a minter is permitted to mint." + }, + "minterToMintedAmount(address)": { + "notice": "A Mapping used to keep track of the amount i.e already minted by minter." + }, + "pause()": { + "notice": "Pauses Token" + }, + "setAccessControlManager(address)": { + "notice": "Sets the address of the access control manager of this contract." + }, + "setMintCap(address,uint256)": { + "notice": "Sets the minting cap for minter." + }, + "unpause()": { + "notice": "Resumes Token" + }, + "updateBlacklist(address,bool)": { + "notice": "Function to update blacklist." + } + }, + "notice": "XVS contract serves as a customized ERC-20 token with additional minting and burning functionality. It also incorporates access control features provided by the \"TokenController\" contract to ensure proper governance and restrictions on minting and burning operations.", + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 5612, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_balances", + "offset": 0, + "slot": "0", + "type": "t_mapping(t_address,t_uint256)" + }, + { + "astId": 5618, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_allowances", + "offset": 0, + "slot": "1", + "type": "t_mapping(t_address,t_mapping(t_address,t_uint256))" + }, + { + "astId": 5620, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_totalSupply", + "offset": 0, + "slot": "2", + "type": "t_uint256" + }, + { + "astId": 5622, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_name", + "offset": 0, + "slot": "3", + "type": "t_string_storage" + }, + { + "astId": 5624, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_symbol", + "offset": 0, + "slot": "4", + "type": "t_string_storage" + }, + { + "astId": 5383, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_owner", + "offset": 0, + "slot": "5", + "type": "t_address" + }, + { + "astId": 5506, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_paused", + "offset": 20, + "slot": "5", + "type": "t_bool" + }, + { + "astId": 11266, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "accessControlManager", + "offset": 0, + "slot": "6", + "type": "t_address" + }, + { + "astId": 11271, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "_blacklist", + "offset": 0, + "slot": "7", + "type": "t_mapping(t_address,t_bool)" + }, + { + "astId": 11276, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "minterToCap", + "offset": 0, + "slot": "8", + "type": "t_mapping(t_address,t_uint256)" + }, + { + "astId": 11281, + "contract": "contracts/Bridge/token/XVS.sol:XVS", + "label": "minterToMintedAmount", + "offset": 0, + "slot": "9", + "type": "t_mapping(t_address,t_uint256)" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + }, + "t_bool": { + "encoding": "inplace", + "label": "bool", + "numberOfBytes": "1" + }, + "t_mapping(t_address,t_bool)": { + "encoding": "mapping", + "key": "t_address", + "label": "mapping(address => bool)", + "numberOfBytes": "32", + "value": "t_bool" + }, + "t_mapping(t_address,t_mapping(t_address,t_uint256))": { + "encoding": "mapping", + "key": "t_address", + "label": "mapping(address => mapping(address => uint256))", + "numberOfBytes": "32", + "value": "t_mapping(t_address,t_uint256)" + }, + "t_mapping(t_address,t_uint256)": { + "encoding": "mapping", + "key": "t_address", + "label": "mapping(address => uint256)", + "numberOfBytes": "32", + "value": "t_uint256" + }, + "t_string_storage": { + "encoding": "bytes", + "label": "string", + "numberOfBytes": "32" + }, + "t_uint256": { + "encoding": "inplace", + "label": "uint256", + "numberOfBytes": "32" + } + } + } +} diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin.json b/deployments/arbitrumsepolia/XVSBridgeAdmin.json new file mode 100644 index 0000000..655e631 --- /dev/null +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin.json @@ -0,0 +1,584 @@ +{ + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "abi": [ + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "changeAdmin", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "string", + "name": "signature", + "type": "string" + }, + { + "indexed": false, + "internalType": "bool", + "name": "active", + "type": "bool" + } + ], + "name": "FunctionRegistryChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "XVSBridge", + "outputs": [ + { + "internalType": "contract IXVSProxyOFT", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bytes4", + "name": "", + "type": "bytes4" + } + ], + "name": "functionRegistry", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "isTrustedRemote", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "setTrustedRemoteAddress", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner_", + "type": "address" + } + ], + "name": "transferBridgeOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "string[]", + "name": "signatures_", + "type": "string[]" + }, + { + "internalType": "bool[]", + "name": "active_", + "type": "bool[]" + } + ], + "name": "upsertSignature", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + } + ], + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "receipt": { + "to": null, + "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", + "contractAddress": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 5, + "gasUsed": "921541", + "logsBloom": "0x00000000000000000000000200000000400000000000000400800000000000040000000000000000000000000000000000200000000000000000000000008000000000000000000000000000000002000001000000000000000000000000000000000000020000000000000000000840000000800000000000000000000000400000000000000000000000000000000000000000000080000000000010800000000000000000000000000000000400000000000000800000000000000000000000000022000000000000100000040000000000000400000000000000000020000000000000000000000000000000000000000800000000000000000000000000", + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f", + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "logs": [ + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": [ + "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", + "0x000000000000000000000000cacdfb7cba8b0f4b4f6c842f4d19b03ef1453235" + ], + "data": "0x", + "logIndex": 10, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": [ + "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" + ], + "data": "0x", + "logIndex": 11, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": ["0x66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f", + "logIndex": 12, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000001", + "logIndex": 13, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a78a1df376c3ceebc5fab574fe6eddbbf76fd03e", + "logIndex": 14, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + } + ], + "blockNumber": 27104954, + "cumulativeGasUsed": "2395016", + "status": 1, + "byzantium": true + }, + "args": [ + "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "0xc4d66de8000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f" + ], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"stateMutability\":\"payable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"changeAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"implementation_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"details\":\"This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \\\"admin cannot fallback to proxy target\\\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\",\"kind\":\"dev\",\"methods\":{\"admin()\":{\"details\":\"Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\"},\"changeAdmin(address)\":{\"details\":\"Changes the admin of the proxy. Emits an {AdminChanged} event. NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.\"},\"constructor\":{\"details\":\"Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\"},\"implementation()\":{\"details\":\"Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\"},\"upgradeTo(address)\":{\"details\":\"Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\"},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/openzeppelin/proxy/transparent/TransparentUpgradeableProxy.sol\":\"TransparentUpgradeableProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/transparent/TransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract TransparentUpgradeableProxy is ERC1967Proxy {\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _changeAdmin(admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.\\n */\\n function changeAdmin(address newAdmin) external virtual ifAdmin {\\n _changeAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n}\\n\",\"keccak256\":\"0x140055a64cf579d622e04f5a198595832bf2cb193cd0005f4f2d4d61ca906253\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x6080604052604051620011b2380380620011b2833981016040819052620000269162000519565b82816200005560017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd620005f9565b6000805160206200116b833981519152146200007557620000756200061f565b6200008382826000620000e7565b50620000b3905060017fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6104620005f9565b6000805160206200114b83398151915214620000d357620000d36200061f565b620000de8262000124565b50505062000688565b620000f2836200017f565b600082511180620001005750805b156200011f576200011d8383620001c160201b620002ff1760201c565b505b505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6200014f620001f0565b604080516001600160a01b03928316815291841660208301520160405180910390a16200017c8162000229565b50565b6200018a81620002de565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060620001e983836040518060600160405280602781526020016200118b6027913962000381565b9392505050565b60006200021a6000805160206200114b83398151915260001b6200046760201b620002731760201c565b546001600160a01b0316919050565b6001600160a01b038116620002945760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b60648201526084015b60405180910390fd5b80620002bd6000805160206200114b83398151915260001b6200046760201b620002731760201c565b80546001600160a01b0319166001600160a01b039290921691909117905550565b620002f4816200046a60201b6200032b1760201c565b620003585760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084016200028b565b80620002bd6000805160206200116b83398151915260001b6200046760201b620002731760201c565b60606001600160a01b0384163b620003eb5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b60648201526084016200028b565b600080856001600160a01b03168560405162000408919062000635565b600060405180830381855af49150503d806000811462000445576040519150601f19603f3d011682016040523d82523d6000602084013e6200044a565b606091505b5090925090506200045d82828662000479565b9695505050505050565b90565b6001600160a01b03163b151590565b606083156200048a575081620001e9565b8251156200049b5782518084602001fd5b8160405162461bcd60e51b81526004016200028b919062000653565b80516001600160a01b0381168114620004cf57600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b8381101562000507578181015183820152602001620004ed565b838111156200011d5750506000910152565b6000806000606084860312156200052f57600080fd5b6200053a84620004b7565b92506200054a60208501620004b7565b60408501519092506001600160401b03808211156200056857600080fd5b818601915086601f8301126200057d57600080fd5b815181811115620005925762000592620004d4565b604051601f8201601f19908116603f01168101908382118183101715620005bd57620005bd620004d4565b81604052828152896020848701011115620005d757600080fd5b620005ea836020830160208801620004ea565b80955050505050509250925092565b6000828210156200061a57634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fd5b6000825162000649818460208701620004ea565b9190910192915050565b602081526000825180602084015262000674816040850160208701620004ea565b601f01601f19169190910160400192915050565b610ab380620006986000396000f3fe60806040526004361061005e5760003560e01c80635c60da1b116100435780635c60da1b146100a85780638f283970146100e6578063f851a440146101065761006d565b80633659cfe6146100755780634f1ef286146100955761006d565b3661006d5761006b61011b565b005b61006b61011b565b34801561008157600080fd5b5061006b61009036600461091f565b610135565b61006b6100a336600461093a565b610196565b3480156100b457600080fd5b506100bd610221565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100f257600080fd5b5061006b61010136600461091f565b610276565b34801561011257600080fd5b506100bd6102ba565b610123610347565b61013361012e610435565b61043f565b565b61013d610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816040518060200160405280600081525060006104a3565b50565b61018b61011b565b61019e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610219576102148383838080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250600192506104a3915050565b505050565b61021461011b565b600061022b610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610435565b905090565b61027361011b565b90565b61027e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816104ce565b60006102c4610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610463565b60606103248383604051806060016040528060278152602001610a576027913961052f565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b61034f610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610133576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b6000610266610657565b3660008037600080366000845af43d6000803e80801561045e573d6000f35b3d6000fd5b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b5473ffffffffffffffffffffffffffffffffffffffff16919050565b6104ac8361067f565b6000825111806104b95750805b15610214576104c883836102ff565b50505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6104f7610463565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301520160405180910390a161018b816106cc565b606073ffffffffffffffffffffffffffffffffffffffff84163b6105d5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e74726163740000000000000000000000000000000000000000000000000000606482015260840161042c565b6000808573ffffffffffffffffffffffffffffffffffffffff16856040516105fd91906109e9565b600060405180830381855af49150503d8060008114610638576040519150601f19603f3d011682016040523d82523d6000602084013e61063d565b606091505b509150915061064d8282866107d8565b9695505050505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610487565b6106888161082b565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b73ffffffffffffffffffffffffffffffffffffffff811661076f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201527f6464726573730000000000000000000000000000000000000000000000000000606482015260840161042c565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905550565b606083156107e7575081610324565b8251156107f75782518084602001fd5b816040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161042c9190610a05565b73ffffffffffffffffffffffffffffffffffffffff81163b6108cf576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e747261637400000000000000000000000000000000000000606482015260840161042c565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610792565b803573ffffffffffffffffffffffffffffffffffffffff8116811461091a57600080fd5b919050565b60006020828403121561093157600080fd5b610324826108f6565b60008060006040848603121561094f57600080fd5b610958846108f6565b9250602084013567ffffffffffffffff8082111561097557600080fd5b818601915086601f83011261098957600080fd5b81358181111561099857600080fd5b8760208285010111156109aa57600080fd5b6020830194508093505050509250925092565b60005b838110156109d85781810151838201526020016109c0565b838111156104c85750506000910152565b600082516109fb8184602087016109bd565b9190910192915050565b6020815260008251806020840152610a248160408501602087016109bd565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220b29caa54336b3ee836679675e9732ec5e526fb3f803cca2fe336cc3555aba62264736f6c634300080a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564", + "deployedBytecode": "0x60806040526004361061005e5760003560e01c80635c60da1b116100435780635c60da1b146100a85780638f283970146100e6578063f851a440146101065761006d565b80633659cfe6146100755780634f1ef286146100955761006d565b3661006d5761006b61011b565b005b61006b61011b565b34801561008157600080fd5b5061006b61009036600461091f565b610135565b61006b6100a336600461093a565b610196565b3480156100b457600080fd5b506100bd610221565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100f257600080fd5b5061006b61010136600461091f565b610276565b34801561011257600080fd5b506100bd6102ba565b610123610347565b61013361012e610435565b61043f565b565b61013d610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816040518060200160405280600081525060006104a3565b50565b61018b61011b565b61019e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610219576102148383838080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250600192506104a3915050565b505050565b61021461011b565b600061022b610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610435565b905090565b61027361011b565b90565b61027e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816104ce565b60006102c4610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610463565b60606103248383604051806060016040528060278152602001610a576027913961052f565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b61034f610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610133576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b6000610266610657565b3660008037600080366000845af43d6000803e80801561045e573d6000f35b3d6000fd5b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b5473ffffffffffffffffffffffffffffffffffffffff16919050565b6104ac8361067f565b6000825111806104b95750805b15610214576104c883836102ff565b50505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6104f7610463565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301520160405180910390a161018b816106cc565b606073ffffffffffffffffffffffffffffffffffffffff84163b6105d5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e74726163740000000000000000000000000000000000000000000000000000606482015260840161042c565b6000808573ffffffffffffffffffffffffffffffffffffffff16856040516105fd91906109e9565b600060405180830381855af49150503d8060008114610638576040519150601f19603f3d011682016040523d82523d6000602084013e61063d565b606091505b509150915061064d8282866107d8565b9695505050505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610487565b6106888161082b565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b73ffffffffffffffffffffffffffffffffffffffff811661076f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201527f6464726573730000000000000000000000000000000000000000000000000000606482015260840161042c565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905550565b606083156107e7575081610324565b8251156107f75782518084602001fd5b816040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161042c9190610a05565b73ffffffffffffffffffffffffffffffffffffffff81163b6108cf576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e747261637400000000000000000000000000000000000000606482015260840161042c565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610792565b803573ffffffffffffffffffffffffffffffffffffffff8116811461091a57600080fd5b919050565b60006020828403121561093157600080fd5b610324826108f6565b60008060006040848603121561094f57600080fd5b610958846108f6565b9250602084013567ffffffffffffffff8082111561097557600080fd5b818601915086601f83011261098957600080fd5b81358181111561099857600080fd5b8760208285010111156109aa57600080fd5b6020830194508093505050509250925092565b60005b838110156109d85781810151838201526020016109c0565b838111156104c85750506000910152565b600082516109fb8184602087016109bd565b9190910192915050565b6020815260008251806020840152610a248160408501602087016109bd565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220b29caa54336b3ee836679675e9732ec5e526fb3f803cca2fe336cc3555aba62264736f6c634300080a0033", + "execute": { + "methodName": "initialize", + "args": ["0xa36AD96441cB931D8dFEAAaC97D3FaB4B39E590F"] + }, + "implementation": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "devdoc": { + "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", + "kind": "dev", + "methods": { + "admin()": { + "details": "Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`" + }, + "changeAdmin(address)": { + "details": "Changes the admin of the proxy. Emits an {AdminChanged} event. NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}." + }, + "constructor": { + "details": "Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}." + }, + "implementation()": { + "details": "Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`" + }, + "upgradeTo(address)": { + "details": "Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}." + }, + "upgradeToAndCall(address,bytes)": { + "details": "Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [], + "types": null + } +} diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json b/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json new file mode 100644 index 0000000..c1dea6e --- /dev/null +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json @@ -0,0 +1,629 @@ +{ + "address": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "XVSBridge_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "string", + "name": "signature", + "type": "string" + }, + { + "indexed": false, + "internalType": "bool", + "name": "active", + "type": "bool" + } + ], + "name": "FunctionRegistryChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "stateMutability": "nonpayable", + "type": "fallback" + }, + { + "inputs": [], + "name": "XVSBridge", + "outputs": [ + { + "internalType": "contract IXVSProxyOFT", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bytes4", + "name": "", + "type": "bytes4" + } + ], + "name": "functionRegistry", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "isTrustedRemote", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "setTrustedRemoteAddress", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner_", + "type": "address" + } + ], + "name": "transferBridgeOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "string[]", + "name": "signatures_", + "type": "string[]" + }, + { + "internalType": "bool[]", + "name": "active_", + "type": "bool[]" + } + ], + "name": "upsertSignature", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ], + "transactionHash": "0x06fc510c4442619cab163901c33cc571ee30189320559aac202a5a5ff9e1c360", + "receipt": { + "to": null, + "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", + "contractAddress": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "transactionIndex": 2, + "gasUsed": "1417014", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080010000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000", + "blockHash": "0xf9c24f53bccdd04a09907818d68da24ccbb3a427bb56392140102590267d2cc9", + "transactionHash": "0x06fc510c4442619cab163901c33cc571ee30189320559aac202a5a5ff9e1c360", + "logs": [ + { + "transactionIndex": 2, + "blockNumber": 27104932, + "transactionHash": "0x06fc510c4442619cab163901c33cc571ee30189320559aac202a5a5ff9e1c360", + "address": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], + "data": "0x00000000000000000000000000000000000000000000000000000000000000ff", + "logIndex": 3, + "blockHash": "0xf9c24f53bccdd04a09907818d68da24ccbb3a427bb56392140102590267d2cc9" + } + ], + "blockNumber": 27104932, + "cumulativeGasUsed": "2537511", + "status": 1, + "byzantium": true + }, + "args": ["0x8A5580d7154F9abb01836655b8594f94719b265C"], + "numDeployments": 1, + "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", + "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"XVSBridge_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"sender\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"calledContract\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"methodSignature\",\"type\":\"string\"}],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"string\",\"name\":\"signature\",\"type\":\"string\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"}],\"name\":\"FunctionRegistryChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferStarted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"stateMutability\":\"nonpayable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"XVSBridge\",\"outputs\":[{\"internalType\":\"contract IXVSProxyOFT\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"acceptOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"contract IAccessControlManagerV8\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"name\":\"functionRegistry\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pendingOwner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner_\",\"type\":\"address\"}],\"name\":\"transferBridgeOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string[]\",\"name\":\"signatures_\",\"type\":\"string[]\"},{\"internalType\":\"bool[]\",\"name\":\"active_\",\"type\":\"bool[]\"}],\"name\":\"upsertSignature\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"acceptOwnership()\":{\"details\":\"The new owner accepts the ownership transfer.\"},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"initialize(address)\":{\"params\":{\"accessControlManager_\":\"Address of access control manager contract.\"}},\"isTrustedRemote(uint16,bytes)\":{\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"},\"returns\":{\"_0\":\"Bool indicating whether the remote chain is trusted or not.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pendingOwner()\":{\"details\":\"Returns the address of the pending owner.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only Governance\",\"custom:event\":\"Emits NewAccessControlManager event\",\"details\":\"Admin function to set address of AccessControlManager\",\"params\":{\"accessControlManager_\":\"The new address of the AccessControlManager\"}},\"setTrustedRemoteAddress(uint16,bytes)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"}},\"transferBridgeOwnership(address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"params\":{\"newOwner_\":\"New owner of the XVS Bridge.\"}},\"transferOwnership(address)\":{\"details\":\"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.\"},\"upsertSignature(string[],bool[])\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits FunctionRegistryChanged if bool value of function changes.\",\"params\":{\"active_\":\"bool value, should be true to add function.\",\"signatures_\":\"Function signature to be added or removed.\"}}},\"stateVariables\":{\"XVSBridge\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"}},\"title\":\"XVSBridgeAdmin\",\"version\":1},\"userdoc\":{\"errors\":{\"Unauthorized(address,address,string)\":[{\"notice\":\"Thrown when the action is prohibited by AccessControlManager\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"FunctionRegistryChanged(string,bool)\":{\"notice\":\"emitted when function registry updated\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when access control manager contract address is changed\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Returns the address of the access control manager contract\"},\"functionRegistry(bytes4)\":{\"notice\":\"A mapping keeps track of function signature associated with function name string.\"},\"isTrustedRemote(uint16,bytes)\":{\"notice\":\"Returns true if remote address is trustedRemote corresponds to chainId_.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of AccessControlManager\"},\"setTrustedRemoteAddress(uint16,bytes)\":{\"notice\":\"Sets trusted remote on particular chain.\"},\"transferBridgeOwnership(address)\":{\"notice\":\"This function transfers the ownership of the bridge from this contract to new owner.\"},\"upsertSignature(string[],bool[])\":{\"notice\":\"A setter for the registry of functions that are allowed to be executed from proposals.\"}},\"notice\":\"The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT. It maintains a registry of function signatures and names, allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSBridgeAdmin.sol\":\"XVSBridgeAdmin\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OwnableUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership} and {acceptOwnership}.\\n *\\n * This module is used through inheritance. It will make available all functions\\n * from parent (Ownable).\\n */\\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\\n function __Ownable2Step_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable2Step_init_unchained() internal onlyInitializing {\\n }\\n address private _pendingOwner;\\n\\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Returns the address of the pending owner.\\n */\\n function pendingOwner() public view virtual returns (address) {\\n return _pendingOwner;\\n }\\n\\n /**\\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual override onlyOwner {\\n _pendingOwner = newOwner;\\n emit OwnershipTransferStarted(owner(), newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual override {\\n delete _pendingOwner;\\n super._transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev The new owner accepts the ownership transfer.\\n */\\n function acceptOwnership() public virtual {\\n address sender = _msgSender();\\n require(pendingOwner() == sender, \\\"Ownable2Step: caller is not the new owner\\\");\\n _transferOwnership(sender);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x84efb8889801b0ac817324aff6acc691d07bbee816b671817132911d287a8c63\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/ContextUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n function __Ownable_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable_init_unchained() internal onlyInitializing {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x4075622496acc77fd6d4de4cc30a8577a744d5c75afad33fdeacf1704d6eda98\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../../utils/AddressUpgradeable.sol\\\";\\n\\n/**\\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\\n *\\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\\n * reused. This mechanism prevents re-execution of each \\\"step\\\" but allows the creation of new initialization steps in\\n * case an upgrade adds a module that needs to be initialized.\\n *\\n * For example:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```solidity\\n * contract MyToken is ERC20Upgradeable {\\n * function initialize() initializer public {\\n * __ERC20_init(\\\"MyToken\\\", \\\"MTK\\\");\\n * }\\n * }\\n *\\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\\n * function initializeV2() reinitializer(2) public {\\n * __ERC20Permit_init(\\\"MyToken\\\");\\n * }\\n * }\\n * ```\\n *\\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\\n *\\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\\n *\\n * [CAUTION]\\n * ====\\n * Avoid leaving a contract uninitialized.\\n *\\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```\\n * /// @custom:oz-upgrades-unsafe-allow constructor\\n * constructor() {\\n * _disableInitializers();\\n * }\\n * ```\\n * ====\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n * @custom:oz-retyped-from bool\\n */\\n uint8 private _initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private _initializing;\\n\\n /**\\n * @dev Triggered when the contract has been initialized or reinitialized.\\n */\\n event Initialized(uint8 version);\\n\\n /**\\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\\n * `onlyInitializing` functions can be used to initialize parent contracts.\\n *\\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\\n * constructor.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier initializer() {\\n bool isTopLevelCall = !_initializing;\\n require(\\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n _initialized = 1;\\n if (isTopLevelCall) {\\n _initializing = true;\\n }\\n _;\\n if (isTopLevelCall) {\\n _initializing = false;\\n emit Initialized(1);\\n }\\n }\\n\\n /**\\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\\n * used to initialize parent contracts.\\n *\\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\\n * are added through upgrades and that require initialization.\\n *\\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\\n * cannot be nested. If one is invoked in the context of another, execution will revert.\\n *\\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\\n * a contract, executing them in the right order is up to the developer or operator.\\n *\\n * WARNING: setting the version to 255 will prevent any future reinitialization.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier reinitializer(uint8 version) {\\n require(!_initializing && _initialized < version, \\\"Initializable: contract is already initialized\\\");\\n _initialized = version;\\n _initializing = true;\\n _;\\n _initializing = false;\\n emit Initialized(version);\\n }\\n\\n /**\\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\\n */\\n modifier onlyInitializing() {\\n require(_initializing, \\\"Initializable: contract is not initializing\\\");\\n _;\\n }\\n\\n /**\\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\\n * through proxies.\\n *\\n * Emits an {Initialized} event the first time it is successfully executed.\\n */\\n function _disableInitializers() internal virtual {\\n require(!_initializing, \\\"Initializable: contract is initializing\\\");\\n if (_initialized != type(uint8).max) {\\n _initialized = type(uint8).max;\\n emit Initialized(type(uint8).max);\\n }\\n }\\n\\n /**\\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\\n */\\n function _getInitializedVersion() internal view returns (uint8) {\\n return _initialized;\\n }\\n\\n /**\\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\\n */\\n function _isInitializing() internal view returns (bool) {\\n return _initializing;\\n }\\n}\\n\",\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary AddressUpgradeable {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract ContextUpgradeable is Initializable {\\n function __Context_init() internal onlyInitializing {\\n }\\n\\n function __Context_init_unchained() internal onlyInitializing {\\n }\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[50] private __gap;\\n}\\n\",\"keccak256\":\"0x963ea7f0b48b032eef72fe3a7582edf78408d6f834115b9feadd673a4d5bd149\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\\\";\\nimport \\\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\\\";\\n\\nimport \\\"./IAccessControlManagerV8.sol\\\";\\n\\n/**\\n * @title AccessControlledV8\\n * @author Venus\\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\\n */\\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\\n /// @notice Access control manager contract\\n IAccessControlManagerV8 private _accessControlManager;\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n\\n /// @notice Emitted when access control manager contract address is changed\\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\\n\\n /// @notice Thrown when the action is prohibited by AccessControlManager\\n error Unauthorized(address sender, address calledContract, string methodSignature);\\n\\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\\n __Ownable2Step_init();\\n __AccessControlled_init_unchained(accessControlManager_);\\n }\\n\\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Sets the address of AccessControlManager\\n * @dev Admin function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n * @custom:event Emits NewAccessControlManager event\\n * @custom:access Only Governance\\n */\\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Returns the address of the access control manager contract\\n */\\n function accessControlManager() external view returns (IAccessControlManagerV8) {\\n return _accessControlManager;\\n }\\n\\n /**\\n * @dev Internal function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n */\\n function _setAccessControlManager(address accessControlManager_) internal {\\n require(address(accessControlManager_) != address(0), \\\"invalid acess control manager address\\\");\\n address oldAccessControlManager = address(_accessControlManager);\\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\\n }\\n\\n /**\\n * @notice Reverts if the call is not allowed by AccessControlManager\\n * @param signature Method signature\\n */\\n function _checkAccessAllowed(string memory signature) internal view {\\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\\n\\n if (!isAllowedToCall) {\\n revert Unauthorized(msg.sender, address(this), signature);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x1b805a5d09990e2c4f7839afe7726a02f8452261eb3d0d488e24129ec0a7736d\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x8adbe291d659987faf4de606736227ad9d8e1a0e284a33a6ca12b30ab2a504b2\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSBridgeAdmin.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\n\\npragma solidity 0.8.13;\\n\\nimport { AccessControlledV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { IXVSProxyOFT } from \\\"./interfaces/IXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSBridgeAdmin\\n * @author Venus\\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\\n * It maintains a registry of function signatures and names,\\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\\n */\\ncontract XVSBridgeAdmin is AccessControlledV8 {\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IXVSProxyOFT public immutable XVSBridge;\\n /**\\n * @notice A mapping keeps track of function signature associated with function name string.\\n */\\n mapping(bytes4 => string) public functionRegistry;\\n\\n /**\\n * @notice emitted when function registry updated\\n */\\n event FunctionRegistryChanged(string signature, bool active);\\n\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(address XVSBridge_) {\\n ensureNonzeroAddress(XVSBridge_);\\n XVSBridge = IXVSProxyOFT(XVSBridge_);\\n _disableInitializers();\\n }\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n */\\n function initialize(address accessControlManager_) external initializer {\\n __AccessControlled_init(accessControlManager_);\\n }\\n\\n /**\\n * @notice Invoked when called function does not exist in the contract.\\n * @return Response of low level call.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n fallback(bytes calldata data) external returns (bytes memory) {\\n string memory fun = _getFunctionName(msg.sig);\\n require(bytes(fun).length != 0, \\\"Function not found\\\");\\n _checkAccessAllowed(fun);\\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\\n require(ok, \\\"call failed\\\");\\n return res;\\n }\\n\\n /**\\n * @notice Sets trusted remote on particular chain.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n */\\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\\n _checkAccessAllowed(\\\"setTrustedRemoteAddress(uint16,bytes)\\\");\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\\n * @param signatures_ Function signature to be added or removed.\\n * @param active_ bool value, should be true to add function.\\n * @custom:access Only owner.\\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\\n */\\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\\n uint256 signatureLength = signatures_.length;\\n require(signatureLength == active_.length, \\\"Input arrays must have the same length\\\");\\n for (uint256 i; i < signatureLength; ) {\\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\\n bytes memory signature = bytes(functionRegistry[sigHash]);\\n if (active_[i] && signature.length == 0) {\\n functionRegistry[sigHash] = signatures_[i];\\n emit FunctionRegistryChanged(signatures_[i], true);\\n } else if (!active_[i] && signature.length != 0) {\\n delete functionRegistry[sigHash];\\n emit FunctionRegistryChanged(signatures_[i], false);\\n }\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /**\\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\\n * @param newOwner_ New owner of the XVS Bridge.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function transferBridgeOwnership(address newOwner_) external {\\n _checkAccessAllowed(\\\"transferBridgeOwnership(address)\\\");\\n XVSBridge.transferOwnership(newOwner_);\\n }\\n\\n /**\\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n * @return Bool indicating whether the remote chain is trusted or not.\\n */\\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @dev Returns function name string associated with function signature.\\n * @param signature_ Four bytes of function signature.\\n * @return Function signature corresponding to its hash.\\n */\\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\\n return functionRegistry[signature_];\\n }\\n\\n /**\\n * @notice Converts given bytes into address.\\n * @param b Bytes to be converted into address.\\n * @return Converted address of given bytes.\\n */\\n function bytesToAddress(bytes calldata b) private pure returns (address) {\\n return address(uint160(bytes20(b)));\\n }\\n}\\n\",\"keccak256\":\"0x3ba34b95f911e1772aca61e6daa00c4ebdb5bee61fc072ffba9e7ff3dc1262cd\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/**\\n * @title IXVSProxyOFT\\n * @author Venus\\n * @notice Interface implemented by `XVSProxyOFT`.\\n */\\ninterface IXVSProxyOFT {\\n function transferOwnership(address addr) external;\\n\\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\\n\\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\\n}\\n\",\"keccak256\":\"0x854518f3e4c2270ca52184e63dc1f9d27f2893388216ee6153e6ab8cf2d7c960\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x60a06040523480156200001157600080fd5b50604051620016ac380380620016ac833981016040819052620000349162000149565b6200003f816200005d565b6001600160a01b0381166080526200005662000088565b506200017b565b6001600160a01b03811662000085576040516342bcdf7f60e11b815260040160405180910390fd5b50565b600054610100900460ff1615620000f55760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161462000147576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b6000602082840312156200015c57600080fd5b81516001600160a01b03811681146200017457600080fd5b9392505050565b6080516114f9620001b3600039600081816101610152818161026c015281816105d6015281816106b70152610b2a01526114f96000f3fe608060405234801561001057600080fd5b50600436106100ea5760003560e01c806379ba50971161008c578063b4a0bdf311610066578063b4a0bdf31461031b578063c4d66de81461032c578063e30c39781461033f578063f2fde38b14610350576100ea565b806379ba5097146102ef5780638da5cb5b146102f7578063a6c3d16514610308576100ea565b80633d8b38f6116100c85780633d8b38f6146102a65780633f90b540146102c95780634bb7453e146102dc578063715018a61461023c576100ea565b80630e32cb8614610229578063180d295c1461023e57806327a020ef14610267575b600036606060006101066000356001600160e01b031916610363565b905080516000036101535760405162461bcd60e51b8152602060048201526012602482015271119d5b98dd1a5bdb881b9bdd08199bdd5b9960721b60448201526064015b60405180910390fd5b61015c81610410565b6000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316868660405161019992919061106b565b6000604051808303816000865af19150503d80600081146101d6576040519150601f19603f3d011682016040523d82523d6000602084013e6101db565b606091505b50915091508161021b5760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161014a565b805195506020019350505050f35b61023c61023736600461107b565b6104ae565b005b61025161024c3660046110ab565b6104c2565b60405161025e9190611122565b60405180910390f35b61028e7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161025e565b6102b96102b4366004611135565b61055c565b604051901515815260200161025e565b61023c6102d736600461107b565b61065a565b61023c6102ea36600461120d565b610716565b61023c610a1f565b6033546001600160a01b031661028e565b61023c610316366004611135565b610a96565b6097546001600160a01b031661028e565b61023c61033a36600461107b565b610b9a565b6065546001600160a01b031661028e565b61023c61035e36600461107b565b610cad565b6001600160e01b03198116600090815260c96020526040902080546060919061038b90611279565b80601f01602080910402602001604051908101604052809291908181526020018280546103b790611279565b80156104045780601f106103d957610100808354040283529160200191610404565b820191906000526020600020905b8154815290600101906020018083116103e757829003601f168201915b50505050509050919050565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061044390339086906004016112b3565b602060405180830381865afa158015610460573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061048491906112e5565b9050806104aa57333083604051634a3fa29360e01b815260040161014a93929190611302565b5050565b6104b6610d1e565b6104bf81610d78565b50565b60c960205260009081526040902080546104db90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461050790611279565b80156105545780601f1061052957610100808354040283529160200191610554565b820191906000526020600020905b81548152906001019060200180831161053757829003601f168201915b505050505081565b60008361ffff166000036105ad5760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b6105bf6105ba8484610e36565b610e4c565b604051631ec59c7b60e11b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633d8b38f69061060f90879087908790600401611360565b6020604051808303816000875af115801561062e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061065291906112e5565b949350505050565b6106986040518060400160405280602081526020017f7472616e736665724272696467654f776e657273686970286164647265737329815250610410565b60405163f2fde38b60e01b81526001600160a01b0382811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063f2fde38b90602401600060405180830381600087803b1580156106fb57600080fd5b505af115801561070f573d6000803e3d6000fd5b5050505050565b61071e610d1e565b8281811461077d5760405162461bcd60e51b815260206004820152602660248201527f496e70757420617272617973206d7573742068617665207468652073616d65206044820152650d8cadccee8d60d31b606482015260840161014a565b60005b81811015610a1557600086868381811061079c5761079c61137e565b90506020028101906107ae9190611394565b6040516107bc92919061106b565b60408051918290039091206001600160e01b03198116600090815260c96020529182208054919350906107ee90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461081a90611279565b80156108675780601f1061083c57610100808354040283529160200191610867565b820191906000526020600020905b81548152906001019060200180831161084a57829003601f168201915b505050505090508585848181106108805761088061137e565b905060200201602081019061089591906113db565b80156108a057508051155b15610951578787848181106108b7576108b761137e565b90506020028101906108c99190611394565b6001600160e01b03198416600090815260c9602052604090206108ed929091610f9c565b507f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109215761092161137e565b90506020028101906109339190611394565b6001604051610944939291906113f8565b60405180910390a1610a0b565b8585848181106109635761096361137e565b905060200201602081019061097891906113db565b1580156109855750805115155b15610a0b576001600160e01b03198216600090815260c9602052604081206109ac91611020565b7f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109df576109df61137e565b90506020028101906109f19190611394565b6000604051610a02939291906113f8565b60405180910390a15b5050600101610780565b505050505050565b565b60655433906001600160a01b03168114610a8d5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840161014a565b6104bf81610e73565b610ab760405180606001604052806025815260200161149f60259139610410565b8261ffff16600003610b065760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b610b136105ba8383610e36565b60405163a6c3d16560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063a6c3d16590610b6390869086908690600401611360565b600060405180830381600087803b158015610b7d57600080fd5b505af1158015610b91573d6000803e3d6000fd5b50505050505050565b600054610100900460ff1615808015610bba5750600054600160ff909116105b80610bd45750303b158015610bd4575060005460ff166001145b610c375760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161014a565b6000805460ff191660011790558015610c5a576000805461ff0019166101001790555b610c6382610e8c565b80156104aa576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020015b60405180910390a15050565b610cb5610d1e565b606580546001600160a01b0383166001600160a01b03199091168117909155610ce66033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b03163314610a1d5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161014a565b6001600160a01b038116610ddc5760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b606482015260840161014a565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa09101610ca1565b6000610e42828461141e565b60601c9392505050565b6001600160a01b0381166104bf576040516342bcdf7f60e11b815260040160405180910390fd5b606580546001600160a01b03191690556104bf81610ec4565b600054610100900460ff16610eb35760405162461bcd60e51b815260040161014a90611453565b610ebb610f16565b6104bf81610f45565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff16610f3d5760405162461bcd60e51b815260040161014a90611453565b610a1d610f6c565b600054610100900460ff166104b65760405162461bcd60e51b815260040161014a90611453565b600054610100900460ff16610f935760405162461bcd60e51b815260040161014a90611453565b610a1d33610e73565b828054610fa890611279565b90600052602060002090601f016020900481019282610fca5760008555611010565b82601f10610fe35782800160ff19823516178555611010565b82800160010185558215611010579182015b82811115611010578235825591602001919060010190610ff5565b5061101c929150611056565b5090565b50805461102c90611279565b6000825580601f1061103c575050565b601f0160209004906000526020600020908101906104bf91905b5b8082111561101c5760008155600101611057565b8183823760009101908152919050565b60006020828403121561108d57600080fd5b81356001600160a01b03811681146110a457600080fd5b9392505050565b6000602082840312156110bd57600080fd5b81356001600160e01b0319811681146110a457600080fd5b6000815180845260005b818110156110fb576020818501810151868301820152016110df565b8181111561110d576000602083870101525b50601f01601f19169290920160200192915050565b6020815260006110a460208301846110d5565b60008060006040848603121561114a57600080fd5b833561ffff8116811461115c57600080fd5b9250602084013567ffffffffffffffff8082111561117957600080fd5b818601915086601f83011261118d57600080fd5b81358181111561119c57600080fd5b8760208285010111156111ae57600080fd5b6020830194508093505050509250925092565b60008083601f8401126111d357600080fd5b50813567ffffffffffffffff8111156111eb57600080fd5b6020830191508360208260051b850101111561120657600080fd5b9250929050565b6000806000806040858703121561122357600080fd5b843567ffffffffffffffff8082111561123b57600080fd5b611247888389016111c1565b9096509450602087013591508082111561126057600080fd5b5061126d878288016111c1565b95989497509550505050565b600181811c9082168061128d57607f821691505b6020821081036112ad57634e487b7160e01b600052602260045260246000fd5b50919050565b6001600160a01b0383168152604060208201819052600090610652908301846110d5565b80151581146104bf57600080fd5b6000602082840312156112f757600080fd5b81516110a4816112d7565b6001600160a01b0384811682528316602082015260606040820181905260009061132e908301846110d5565b95945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff8416815260406020820152600061132e604083018486611337565b634e487b7160e01b600052603260045260246000fd5b6000808335601e198436030181126113ab57600080fd5b83018035915067ffffffffffffffff8211156113c657600080fd5b60200191503681900382131561120657600080fd5b6000602082840312156113ed57600080fd5b81356110a4816112d7565b60408152600061140c604083018587611337565b90508215156020830152949350505050565b6bffffffffffffffffffffffff19813581811691601485101561144b5780818660140360031b1b83161692505b505092915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b60608201526080019056fe7365745472757374656452656d6f7465416464726573732875696e7431362c627974657329a2646970667358221220ac99e6bde2c9eb9bdd52a744515930950de54cf45081e77327e35b07ad11a96064736f6c634300080d0033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100ea5760003560e01c806379ba50971161008c578063b4a0bdf311610066578063b4a0bdf31461031b578063c4d66de81461032c578063e30c39781461033f578063f2fde38b14610350576100ea565b806379ba5097146102ef5780638da5cb5b146102f7578063a6c3d16514610308576100ea565b80633d8b38f6116100c85780633d8b38f6146102a65780633f90b540146102c95780634bb7453e146102dc578063715018a61461023c576100ea565b80630e32cb8614610229578063180d295c1461023e57806327a020ef14610267575b600036606060006101066000356001600160e01b031916610363565b905080516000036101535760405162461bcd60e51b8152602060048201526012602482015271119d5b98dd1a5bdb881b9bdd08199bdd5b9960721b60448201526064015b60405180910390fd5b61015c81610410565b6000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316868660405161019992919061106b565b6000604051808303816000865af19150503d80600081146101d6576040519150601f19603f3d011682016040523d82523d6000602084013e6101db565b606091505b50915091508161021b5760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161014a565b805195506020019350505050f35b61023c61023736600461107b565b6104ae565b005b61025161024c3660046110ab565b6104c2565b60405161025e9190611122565b60405180910390f35b61028e7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161025e565b6102b96102b4366004611135565b61055c565b604051901515815260200161025e565b61023c6102d736600461107b565b61065a565b61023c6102ea36600461120d565b610716565b61023c610a1f565b6033546001600160a01b031661028e565b61023c610316366004611135565b610a96565b6097546001600160a01b031661028e565b61023c61033a36600461107b565b610b9a565b6065546001600160a01b031661028e565b61023c61035e36600461107b565b610cad565b6001600160e01b03198116600090815260c96020526040902080546060919061038b90611279565b80601f01602080910402602001604051908101604052809291908181526020018280546103b790611279565b80156104045780601f106103d957610100808354040283529160200191610404565b820191906000526020600020905b8154815290600101906020018083116103e757829003601f168201915b50505050509050919050565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061044390339086906004016112b3565b602060405180830381865afa158015610460573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061048491906112e5565b9050806104aa57333083604051634a3fa29360e01b815260040161014a93929190611302565b5050565b6104b6610d1e565b6104bf81610d78565b50565b60c960205260009081526040902080546104db90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461050790611279565b80156105545780601f1061052957610100808354040283529160200191610554565b820191906000526020600020905b81548152906001019060200180831161053757829003601f168201915b505050505081565b60008361ffff166000036105ad5760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b6105bf6105ba8484610e36565b610e4c565b604051631ec59c7b60e11b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633d8b38f69061060f90879087908790600401611360565b6020604051808303816000875af115801561062e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061065291906112e5565b949350505050565b6106986040518060400160405280602081526020017f7472616e736665724272696467654f776e657273686970286164647265737329815250610410565b60405163f2fde38b60e01b81526001600160a01b0382811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063f2fde38b90602401600060405180830381600087803b1580156106fb57600080fd5b505af115801561070f573d6000803e3d6000fd5b5050505050565b61071e610d1e565b8281811461077d5760405162461bcd60e51b815260206004820152602660248201527f496e70757420617272617973206d7573742068617665207468652073616d65206044820152650d8cadccee8d60d31b606482015260840161014a565b60005b81811015610a1557600086868381811061079c5761079c61137e565b90506020028101906107ae9190611394565b6040516107bc92919061106b565b60408051918290039091206001600160e01b03198116600090815260c96020529182208054919350906107ee90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461081a90611279565b80156108675780601f1061083c57610100808354040283529160200191610867565b820191906000526020600020905b81548152906001019060200180831161084a57829003601f168201915b505050505090508585848181106108805761088061137e565b905060200201602081019061089591906113db565b80156108a057508051155b15610951578787848181106108b7576108b761137e565b90506020028101906108c99190611394565b6001600160e01b03198416600090815260c9602052604090206108ed929091610f9c565b507f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109215761092161137e565b90506020028101906109339190611394565b6001604051610944939291906113f8565b60405180910390a1610a0b565b8585848181106109635761096361137e565b905060200201602081019061097891906113db565b1580156109855750805115155b15610a0b576001600160e01b03198216600090815260c9602052604081206109ac91611020565b7f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109df576109df61137e565b90506020028101906109f19190611394565b6000604051610a02939291906113f8565b60405180910390a15b5050600101610780565b505050505050565b565b60655433906001600160a01b03168114610a8d5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840161014a565b6104bf81610e73565b610ab760405180606001604052806025815260200161149f60259139610410565b8261ffff16600003610b065760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b610b136105ba8383610e36565b60405163a6c3d16560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063a6c3d16590610b6390869086908690600401611360565b600060405180830381600087803b158015610b7d57600080fd5b505af1158015610b91573d6000803e3d6000fd5b50505050505050565b600054610100900460ff1615808015610bba5750600054600160ff909116105b80610bd45750303b158015610bd4575060005460ff166001145b610c375760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161014a565b6000805460ff191660011790558015610c5a576000805461ff0019166101001790555b610c6382610e8c565b80156104aa576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020015b60405180910390a15050565b610cb5610d1e565b606580546001600160a01b0383166001600160a01b03199091168117909155610ce66033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b03163314610a1d5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161014a565b6001600160a01b038116610ddc5760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b606482015260840161014a565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa09101610ca1565b6000610e42828461141e565b60601c9392505050565b6001600160a01b0381166104bf576040516342bcdf7f60e11b815260040160405180910390fd5b606580546001600160a01b03191690556104bf81610ec4565b600054610100900460ff16610eb35760405162461bcd60e51b815260040161014a90611453565b610ebb610f16565b6104bf81610f45565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff16610f3d5760405162461bcd60e51b815260040161014a90611453565b610a1d610f6c565b600054610100900460ff166104b65760405162461bcd60e51b815260040161014a90611453565b600054610100900460ff16610f935760405162461bcd60e51b815260040161014a90611453565b610a1d33610e73565b828054610fa890611279565b90600052602060002090601f016020900481019282610fca5760008555611010565b82601f10610fe35782800160ff19823516178555611010565b82800160010185558215611010579182015b82811115611010578235825591602001919060010190610ff5565b5061101c929150611056565b5090565b50805461102c90611279565b6000825580601f1061103c575050565b601f0160209004906000526020600020908101906104bf91905b5b8082111561101c5760008155600101611057565b8183823760009101908152919050565b60006020828403121561108d57600080fd5b81356001600160a01b03811681146110a457600080fd5b9392505050565b6000602082840312156110bd57600080fd5b81356001600160e01b0319811681146110a457600080fd5b6000815180845260005b818110156110fb576020818501810151868301820152016110df565b8181111561110d576000602083870101525b50601f01601f19169290920160200192915050565b6020815260006110a460208301846110d5565b60008060006040848603121561114a57600080fd5b833561ffff8116811461115c57600080fd5b9250602084013567ffffffffffffffff8082111561117957600080fd5b818601915086601f83011261118d57600080fd5b81358181111561119c57600080fd5b8760208285010111156111ae57600080fd5b6020830194508093505050509250925092565b60008083601f8401126111d357600080fd5b50813567ffffffffffffffff8111156111eb57600080fd5b6020830191508360208260051b850101111561120657600080fd5b9250929050565b6000806000806040858703121561122357600080fd5b843567ffffffffffffffff8082111561123b57600080fd5b611247888389016111c1565b9096509450602087013591508082111561126057600080fd5b5061126d878288016111c1565b95989497509550505050565b600181811c9082168061128d57607f821691505b6020821081036112ad57634e487b7160e01b600052602260045260246000fd5b50919050565b6001600160a01b0383168152604060208201819052600090610652908301846110d5565b80151581146104bf57600080fd5b6000602082840312156112f757600080fd5b81516110a4816112d7565b6001600160a01b0384811682528316602082015260606040820181905260009061132e908301846110d5565b95945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff8416815260406020820152600061132e604083018486611337565b634e487b7160e01b600052603260045260246000fd5b6000808335601e198436030181126113ab57600080fd5b83018035915067ffffffffffffffff8211156113c657600080fd5b60200191503681900382131561120657600080fd5b6000602082840312156113ed57600080fd5b81356110a4816112d7565b60408152600061140c604083018587611337565b90508215156020830152949350505050565b6bffffffffffffffffffffffff19813581811691601485101561144b5780818660140360031b1b83161692505b505092915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b60608201526080019056fe7365745472757374656452656d6f7465416464726573732875696e7431362c627974657329a2646970667358221220ac99e6bde2c9eb9bdd52a744515930950de54cf45081e77327e35b07ad11a96064736f6c634300080d0033", + "devdoc": { + "author": "Venus", + "kind": "dev", + "methods": { + "acceptOwnership()": { + "details": "The new owner accepts the ownership transfer." + }, + "constructor": { + "custom:oz-upgrades-unsafe-allow": "constructor" + }, + "initialize(address)": { + "params": { + "accessControlManager_": "Address of access control manager contract." + } + }, + "isTrustedRemote(uint16,bytes)": { + "custom:error": "ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.", + "params": { + "remoteAddress_": "Address of the destination bridge.", + "remoteChainId_": "Chain Id of the destination chain." + }, + "returns": { + "_0": "Bool indicating whether the remote chain is trusted or not." + } + }, + "owner()": { + "details": "Returns the address of the current owner." + }, + "pendingOwner()": { + "details": "Returns the address of the pending owner." + }, + "setAccessControlManager(address)": { + "custom:access": "Only Governance", + "custom:event": "Emits NewAccessControlManager event", + "details": "Admin function to set address of AccessControlManager", + "params": { + "accessControlManager_": "The new address of the AccessControlManager" + } + }, + "setTrustedRemoteAddress(uint16,bytes)": { + "custom:access": "Controlled by AccessControlManager.", + "custom:error": "ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.", + "params": { + "remoteAddress_": "Address of the destination bridge.", + "remoteChainId_": "Chain Id of the destination chain." + } + }, + "transferBridgeOwnership(address)": { + "custom:access": "Controlled by AccessControlManager.", + "params": { + "newOwner_": "New owner of the XVS Bridge." + } + }, + "transferOwnership(address)": { + "details": "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." + }, + "upsertSignature(string[],bool[])": { + "custom:access": "Only owner.", + "custom:event": "Emits FunctionRegistryChanged if bool value of function changes.", + "params": { + "active_": "bool value, should be true to add function.", + "signatures_": "Function signature to be added or removed." + } + } + }, + "stateVariables": { + "XVSBridge": { + "custom:oz-upgrades-unsafe-allow": "state-variable-immutable" + } + }, + "title": "XVSBridgeAdmin", + "version": 1 + }, + "userdoc": { + "errors": { + "Unauthorized(address,address,string)": [ + { + "notice": "Thrown when the action is prohibited by AccessControlManager" + } + ], + "ZeroAddressNotAllowed()": [ + { + "notice": "Thrown if the supplied address is a zero address where it is not allowed" + } + ] + }, + "events": { + "FunctionRegistryChanged(string,bool)": { + "notice": "emitted when function registry updated" + }, + "NewAccessControlManager(address,address)": { + "notice": "Emitted when access control manager contract address is changed" + } + }, + "kind": "user", + "methods": { + "accessControlManager()": { + "notice": "Returns the address of the access control manager contract" + }, + "functionRegistry(bytes4)": { + "notice": "A mapping keeps track of function signature associated with function name string." + }, + "isTrustedRemote(uint16,bytes)": { + "notice": "Returns true if remote address is trustedRemote corresponds to chainId_." + }, + "renounceOwnership()": { + "notice": "Empty implementation of renounce ownership to avoid any mishappening." + }, + "setAccessControlManager(address)": { + "notice": "Sets the address of AccessControlManager" + }, + "setTrustedRemoteAddress(uint16,bytes)": { + "notice": "Sets trusted remote on particular chain." + }, + "transferBridgeOwnership(address)": { + "notice": "This function transfers the ownership of the bridge from this contract to new owner." + }, + "upsertSignature(string[],bool[])": { + "notice": "A setter for the registry of functions that are allowed to be executed from proposals." + } + }, + "notice": "The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT. It maintains a registry of function signatures and names, allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.", + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 4452, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "_initialized", + "offset": 0, + "slot": "0", + "type": "t_uint8" + }, + { + "astId": 4455, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "_initializing", + "offset": 1, + "slot": "0", + "type": "t_bool" + }, + { + "astId": 4985, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "__gap", + "offset": 0, + "slot": "1", + "type": "t_array(t_uint256)50_storage" + }, + { + "astId": 4324, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "_owner", + "offset": 0, + "slot": "51", + "type": "t_address" + }, + { + "astId": 4444, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "__gap", + "offset": 0, + "slot": "52", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 4233, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "_pendingOwner", + "offset": 0, + "slot": "101", + "type": "t_address" + }, + { + "astId": 4312, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "__gap", + "offset": 0, + "slot": "102", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 8479, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "_accessControlManager", + "offset": 0, + "slot": "151", + "type": "t_contract(IAccessControlManagerV8)8664" + }, + { + "astId": 8484, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "__gap", + "offset": 0, + "slot": "152", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 10420, + "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", + "label": "functionRegistry", + "offset": 0, + "slot": "201", + "type": "t_mapping(t_bytes4,t_string_storage)" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + }, + "t_array(t_uint256)49_storage": { + "base": "t_uint256", + "encoding": "inplace", + "label": "uint256[49]", + "numberOfBytes": "1568" + }, + "t_array(t_uint256)50_storage": { + "base": "t_uint256", + "encoding": "inplace", + "label": "uint256[50]", + "numberOfBytes": "1600" + }, + "t_bool": { + "encoding": "inplace", + "label": "bool", + "numberOfBytes": "1" + }, + "t_bytes4": { + "encoding": "inplace", + "label": "bytes4", + "numberOfBytes": "4" + }, + "t_contract(IAccessControlManagerV8)8664": { + "encoding": "inplace", + "label": "contract IAccessControlManagerV8", + "numberOfBytes": "20" + }, + "t_mapping(t_bytes4,t_string_storage)": { + "encoding": "mapping", + "key": "t_bytes4", + "label": "mapping(bytes4 => string)", + "numberOfBytes": "32", + "value": "t_string_storage" + }, + "t_string_storage": { + "encoding": "bytes", + "label": "string", + "numberOfBytes": "32" + }, + "t_uint256": { + "encoding": "inplace", + "label": "uint256", + "numberOfBytes": "32" + }, + "t_uint8": { + "encoding": "inplace", + "label": "uint8", + "numberOfBytes": "1" + } + } + } +} diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json b/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json new file mode 100644 index 0000000..b962385 --- /dev/null +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json @@ -0,0 +1,267 @@ +{ + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "changeAdmin", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + } + ], + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "receipt": { + "to": null, + "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", + "contractAddress": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 5, + "gasUsed": "921541", + "logsBloom": "0x00000000000000000000000200000000400000000000000400800000000000040000000000000000000000000000000000200000000000000000000000008000000000000000000000000000000002000001000000000000000000000000000000000000020000000000000000000840000000800000000000000000000000400000000000000000000000000000000000000000000080000000000010800000000000000000000000000000000400000000000000800000000000000000000000000022000000000000100000040000000000000400000000000000000020000000000000000000000000000000000000000800000000000000000000000000", + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f", + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "logs": [ + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": [ + "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", + "0x000000000000000000000000cacdfb7cba8b0f4b4f6c842f4d19b03ef1453235" + ], + "data": "0x", + "logIndex": 10, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": [ + "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" + ], + "data": "0x", + "logIndex": 11, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": ["0x66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f", + "logIndex": 12, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000001", + "logIndex": 13, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + }, + { + "transactionIndex": 5, + "blockNumber": 27104954, + "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a78a1df376c3ceebc5fab574fe6eddbbf76fd03e", + "logIndex": 14, + "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + } + ], + "blockNumber": 27104954, + "cumulativeGasUsed": "2395016", + "status": 1, + "byzantium": true + }, + "args": [ + "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "0xc4d66de8000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f" + ], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"stateMutability\":\"payable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"changeAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"implementation_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"details\":\"This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \\\"admin cannot fallback to proxy target\\\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\",\"kind\":\"dev\",\"methods\":{\"admin()\":{\"details\":\"Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\"},\"changeAdmin(address)\":{\"details\":\"Changes the admin of the proxy. Emits an {AdminChanged} event. NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.\"},\"constructor\":{\"details\":\"Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\"},\"implementation()\":{\"details\":\"Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\"},\"upgradeTo(address)\":{\"details\":\"Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\"},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/openzeppelin/proxy/transparent/TransparentUpgradeableProxy.sol\":\"TransparentUpgradeableProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/transparent/TransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract TransparentUpgradeableProxy is ERC1967Proxy {\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _changeAdmin(admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.\\n */\\n function changeAdmin(address newAdmin) external virtual ifAdmin {\\n _changeAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n}\\n\",\"keccak256\":\"0x140055a64cf579d622e04f5a198595832bf2cb193cd0005f4f2d4d61ca906253\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x6080604052604051620011b2380380620011b2833981016040819052620000269162000519565b82816200005560017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd620005f9565b6000805160206200116b833981519152146200007557620000756200061f565b6200008382826000620000e7565b50620000b3905060017fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6104620005f9565b6000805160206200114b83398151915214620000d357620000d36200061f565b620000de8262000124565b50505062000688565b620000f2836200017f565b600082511180620001005750805b156200011f576200011d8383620001c160201b620002ff1760201c565b505b505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6200014f620001f0565b604080516001600160a01b03928316815291841660208301520160405180910390a16200017c8162000229565b50565b6200018a81620002de565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060620001e983836040518060600160405280602781526020016200118b6027913962000381565b9392505050565b60006200021a6000805160206200114b83398151915260001b6200046760201b620002731760201c565b546001600160a01b0316919050565b6001600160a01b038116620002945760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b60648201526084015b60405180910390fd5b80620002bd6000805160206200114b83398151915260001b6200046760201b620002731760201c565b80546001600160a01b0319166001600160a01b039290921691909117905550565b620002f4816200046a60201b6200032b1760201c565b620003585760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084016200028b565b80620002bd6000805160206200116b83398151915260001b6200046760201b620002731760201c565b60606001600160a01b0384163b620003eb5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b60648201526084016200028b565b600080856001600160a01b03168560405162000408919062000635565b600060405180830381855af49150503d806000811462000445576040519150601f19603f3d011682016040523d82523d6000602084013e6200044a565b606091505b5090925090506200045d82828662000479565b9695505050505050565b90565b6001600160a01b03163b151590565b606083156200048a575081620001e9565b8251156200049b5782518084602001fd5b8160405162461bcd60e51b81526004016200028b919062000653565b80516001600160a01b0381168114620004cf57600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b8381101562000507578181015183820152602001620004ed565b838111156200011d5750506000910152565b6000806000606084860312156200052f57600080fd5b6200053a84620004b7565b92506200054a60208501620004b7565b60408501519092506001600160401b03808211156200056857600080fd5b818601915086601f8301126200057d57600080fd5b815181811115620005925762000592620004d4565b604051601f8201601f19908116603f01168101908382118183101715620005bd57620005bd620004d4565b81604052828152896020848701011115620005d757600080fd5b620005ea836020830160208801620004ea565b80955050505050509250925092565b6000828210156200061a57634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fd5b6000825162000649818460208701620004ea565b9190910192915050565b602081526000825180602084015262000674816040850160208701620004ea565b601f01601f19169190910160400192915050565b610ab380620006986000396000f3fe60806040526004361061005e5760003560e01c80635c60da1b116100435780635c60da1b146100a85780638f283970146100e6578063f851a440146101065761006d565b80633659cfe6146100755780634f1ef286146100955761006d565b3661006d5761006b61011b565b005b61006b61011b565b34801561008157600080fd5b5061006b61009036600461091f565b610135565b61006b6100a336600461093a565b610196565b3480156100b457600080fd5b506100bd610221565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100f257600080fd5b5061006b61010136600461091f565b610276565b34801561011257600080fd5b506100bd6102ba565b610123610347565b61013361012e610435565b61043f565b565b61013d610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816040518060200160405280600081525060006104a3565b50565b61018b61011b565b61019e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610219576102148383838080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250600192506104a3915050565b505050565b61021461011b565b600061022b610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610435565b905090565b61027361011b565b90565b61027e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816104ce565b60006102c4610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610463565b60606103248383604051806060016040528060278152602001610a576027913961052f565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b61034f610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610133576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b6000610266610657565b3660008037600080366000845af43d6000803e80801561045e573d6000f35b3d6000fd5b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b5473ffffffffffffffffffffffffffffffffffffffff16919050565b6104ac8361067f565b6000825111806104b95750805b15610214576104c883836102ff565b50505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6104f7610463565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301520160405180910390a161018b816106cc565b606073ffffffffffffffffffffffffffffffffffffffff84163b6105d5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e74726163740000000000000000000000000000000000000000000000000000606482015260840161042c565b6000808573ffffffffffffffffffffffffffffffffffffffff16856040516105fd91906109e9565b600060405180830381855af49150503d8060008114610638576040519150601f19603f3d011682016040523d82523d6000602084013e61063d565b606091505b509150915061064d8282866107d8565b9695505050505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610487565b6106888161082b565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b73ffffffffffffffffffffffffffffffffffffffff811661076f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201527f6464726573730000000000000000000000000000000000000000000000000000606482015260840161042c565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905550565b606083156107e7575081610324565b8251156107f75782518084602001fd5b816040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161042c9190610a05565b73ffffffffffffffffffffffffffffffffffffffff81163b6108cf576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e747261637400000000000000000000000000000000000000606482015260840161042c565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610792565b803573ffffffffffffffffffffffffffffffffffffffff8116811461091a57600080fd5b919050565b60006020828403121561093157600080fd5b610324826108f6565b60008060006040848603121561094f57600080fd5b610958846108f6565b9250602084013567ffffffffffffffff8082111561097557600080fd5b818601915086601f83011261098957600080fd5b81358181111561099857600080fd5b8760208285010111156109aa57600080fd5b6020830194508093505050509250925092565b60005b838110156109d85781810151838201526020016109c0565b838111156104c85750506000910152565b600082516109fb8184602087016109bd565b9190910192915050565b6020815260008251806020840152610a248160408501602087016109bd565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220b29caa54336b3ee836679675e9732ec5e526fb3f803cca2fe336cc3555aba62264736f6c634300080a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564", + "deployedBytecode": "0x60806040526004361061005e5760003560e01c80635c60da1b116100435780635c60da1b146100a85780638f283970146100e6578063f851a440146101065761006d565b80633659cfe6146100755780634f1ef286146100955761006d565b3661006d5761006b61011b565b005b61006b61011b565b34801561008157600080fd5b5061006b61009036600461091f565b610135565b61006b6100a336600461093a565b610196565b3480156100b457600080fd5b506100bd610221565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100f257600080fd5b5061006b61010136600461091f565b610276565b34801561011257600080fd5b506100bd6102ba565b610123610347565b61013361012e610435565b61043f565b565b61013d610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816040518060200160405280600081525060006104a3565b50565b61018b61011b565b61019e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610219576102148383838080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250600192506104a3915050565b505050565b61021461011b565b600061022b610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610435565b905090565b61027361011b565b90565b61027e610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561018e5761018b816104ce565b60006102c4610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561026b57610266610463565b60606103248383604051806060016040528060278152602001610a576027913961052f565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b61034f610463565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff161415610133576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b6000610266610657565b3660008037600080366000845af43d6000803e80801561045e573d6000f35b3d6000fd5b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b5473ffffffffffffffffffffffffffffffffffffffff16919050565b6104ac8361067f565b6000825111806104b95750805b15610214576104c883836102ff565b50505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6104f7610463565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301520160405180910390a161018b816106cc565b606073ffffffffffffffffffffffffffffffffffffffff84163b6105d5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e74726163740000000000000000000000000000000000000000000000000000606482015260840161042c565b6000808573ffffffffffffffffffffffffffffffffffffffff16856040516105fd91906109e9565b600060405180830381855af49150503d8060008114610638576040519150601f19603f3d011682016040523d82523d6000602084013e61063d565b606091505b509150915061064d8282866107d8565b9695505050505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610487565b6106888161082b565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b73ffffffffffffffffffffffffffffffffffffffff811661076f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201527f6464726573730000000000000000000000000000000000000000000000000000606482015260840161042c565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905550565b606083156107e7575081610324565b8251156107f75782518084602001fd5b816040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161042c9190610a05565b73ffffffffffffffffffffffffffffffffffffffff81163b6108cf576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e747261637400000000000000000000000000000000000000606482015260840161042c565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610792565b803573ffffffffffffffffffffffffffffffffffffffff8116811461091a57600080fd5b919050565b60006020828403121561093157600080fd5b610324826108f6565b60008060006040848603121561094f57600080fd5b610958846108f6565b9250602084013567ffffffffffffffff8082111561097557600080fd5b818601915086601f83011261098957600080fd5b81358181111561099857600080fd5b8760208285010111156109aa57600080fd5b6020830194508093505050509250925092565b60005b838110156109d85781810151838201526020016109c0565b838111156104c85750506000910152565b600082516109fb8184602087016109bd565b9190910192915050565b6020815260008251806020840152610a248160408501602087016109bd565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220b29caa54336b3ee836679675e9732ec5e526fb3f803cca2fe336cc3555aba62264736f6c634300080a0033", + "devdoc": { + "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", + "kind": "dev", + "methods": { + "admin()": { + "details": "Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`" + }, + "changeAdmin(address)": { + "details": "Changes the admin of the proxy. Emits an {AdminChanged} event. NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}." + }, + "constructor": { + "details": "Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}." + }, + "implementation()": { + "details": "Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`" + }, + "upgradeTo(address)": { + "details": "Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}." + }, + "upgradeToAndCall(address,bytes)": { + "details": "Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [], + "types": null + } +} diff --git a/deployments/arbitrumsepolia/XVSProxyOFTDest.json b/deployments/arbitrumsepolia/XVSProxyOFTDest.json new file mode 100644 index 0000000..e5aa17e --- /dev/null +++ b/deployments/arbitrumsepolia/XVSProxyOFTDest.json @@ -0,0 +1,2518 @@ +{ + "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "tokenAddress_", + "type": "address" + }, + { + "internalType": "uint8", + "name": "sharedDecimals_", + "type": "uint8" + }, + { + "internalType": "address", + "name": "lzEndpoint_", + "type": "address" + }, + { + "internalType": "address", + "name": "oracle_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "sweepAmount", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "balance", + "type": "uint256" + } + ], + "name": "InsufficientBalance", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "indexed": false, + "internalType": "bytes32", + "name": "_hash", + "type": "bytes32" + } + ], + "name": "CallOFTReceivedSuccess", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "srcChainId", + "type": "uint16" + }, + { + "indexed": true, + "internalType": "bytes", + "name": "srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "nonce", + "type": "uint64" + } + ], + "name": "DropFailedMessage", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "innerToken", + "type": "address" + } + ], + "name": "InnerTokenAdded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_reason", + "type": "bytes" + } + ], + "name": "MessageFailed", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "_address", + "type": "address" + } + ], + "name": "NonContractAddress", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "oldOracle", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOracle", + "type": "address" + } + ], + "name": "OracleChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Paused", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": true, + "internalType": "address", + "name": "_to", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + } + ], + "name": "ReceiveFromChain", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "indexed": false, + "internalType": "bytes32", + "name": "_payloadHash", + "type": "bytes32" + } + ], + "name": "RetryMessageSuccess", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "indexed": true, + "internalType": "address", + "name": "_from", + "type": "address" + }, + { + "indexed": true, + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + } + ], + "name": "SendToChain", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxDailyLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxDailyReceiveLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxSingleReceiveTransactionLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxSingleTransactionLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint16", + "name": "_type", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "_minDstGas", + "type": "uint256" + } + ], + "name": "SetMinDstGas", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "precrime", + "type": "address" + } + ], + "name": "SetPrecrime", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_path", + "type": "bytes" + } + ], + "name": "SetTrustedRemote", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_remoteAddress", + "type": "bytes" + } + ], + "name": "SetTrustedRemoteAddress", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "addr", + "type": "address" + }, + { + "indexed": false, + "internalType": "bool", + "name": "isWhitelist", + "type": "bool" + } + ], + "name": "SetWhitelist", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "token", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "sweepAmount", + "type": "uint256" + } + ], + "name": "SweepToken", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + } + ], + "name": "TrustedRemoteRemoved", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Unpaused", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "bool", + "name": "enabled", + "type": "bool" + } + ], + "name": "UpdateSendAndCallEnabled", + "type": "event" + }, + { + "inputs": [], + "name": "DEFAULT_PAYLOAD_SIZE_LIMIT", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "NO_EXTRA_GAS", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "PT_SEND", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "PT_SEND_AND_CALL", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes32", + "name": "_from", + "type": "bytes32" + }, + { + "internalType": "address", + "name": "_to", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + }, + { + "internalType": "uint256", + "name": "_gasForCall", + "type": "uint256" + } + ], + "name": "callOnOFTReceived", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourReceiveWindowStart", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourReceived", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourTransferred", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourWindowStart", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxDailyLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxDailyReceiveLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxSingleReceiveTransactionLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxSingleTransactionLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "circulatingSupply", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "", + "type": "uint64" + } + ], + "name": "creditedPackets", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "srcChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "srcAddress_", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "nonce_", + "type": "uint64" + } + ], + "name": "dropFailedMessage", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_dstGasForCall", + "type": "uint64" + }, + { + "internalType": "bool", + "name": "_useZro", + "type": "bool" + }, + { + "internalType": "bytes", + "name": "_adapterParams", + "type": "bytes" + } + ], + "name": "estimateSendAndCallFee", + "outputs": [ + { + "internalType": "uint256", + "name": "nativeFee", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "zroFee", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "internalType": "bool", + "name": "_useZro", + "type": "bool" + }, + { + "internalType": "bytes", + "name": "_adapterParams", + "type": "bytes" + } + ], + "name": "estimateSendFee", + "outputs": [ + { + "internalType": "uint256", + "name": "nativeFee", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "zroFee", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "", + "type": "uint64" + } + ], + "name": "failedMessages", + "outputs": [ + { + "internalType": "bytes32", + "name": "", + "type": "bytes32" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + } + ], + "name": "forceResumeReceive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "_chainId", + "type": "uint16" + }, + { + "internalType": "address", + "name": "", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_configType", + "type": "uint256" + } + ], + "name": "getConfig", + "outputs": [ + { + "internalType": "bytes", + "name": "", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + } + ], + "name": "getTrustedRemoteAddress", + "outputs": [ + { + "internalType": "bytes", + "name": "", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "from_", + "type": "address" + }, + { + "internalType": "uint16", + "name": "dstChainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "isEligibleToSend", + "outputs": [ + { + "internalType": "bool", + "name": "eligibleToSend", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "maxSingleTransactionLimit", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "maxDailyLimit", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "amountInUsd", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "transferredInWindow", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "last24HourWindowStart", + "type": "uint256" + }, + { + "internalType": "bool", + "name": "isWhiteListedUser", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + } + ], + "name": "isTrustedRemote", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "lzEndpoint", + "outputs": [ + { + "internalType": "contract ILayerZeroEndpoint", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + } + ], + "name": "lzReceive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "minDstGasLookup", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + } + ], + "name": "nonblockingLzReceive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "oracle", + "outputs": [ + { + "internalType": "contract ResilientOracleInterface", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "paused", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "payloadSizeLimitLookup", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "precrime", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + } + ], + "name": "removeTrustedRemote", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + } + ], + "name": "retryMessage", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "from_", + "type": "address" + }, + { + "internalType": "uint16", + "name": "dstChainId_", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "toAddress_", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "payload_", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "dstGasForCall_", + "type": "uint64" + }, + { + "components": [ + { + "internalType": "address payable", + "name": "refundAddress", + "type": "address" + }, + { + "internalType": "address", + "name": "zroPaymentAddress", + "type": "address" + }, + { + "internalType": "bytes", + "name": "adapterParams", + "type": "bytes" + } + ], + "internalType": "struct ICommonOFT.LzCallParams", + "name": "callparams_", + "type": "tuple" + } + ], + "name": "sendAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [], + "name": "sendAndCallEnabled", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_from", + "type": "address" + }, + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "components": [ + { + "internalType": "address payable", + "name": "refundAddress", + "type": "address" + }, + { + "internalType": "address", + "name": "zroPaymentAddress", + "type": "address" + }, + { + "internalType": "bytes", + "name": "adapterParams", + "type": "bytes" + } + ], + "internalType": "struct ICommonOFT.LzCallParams", + "name": "_callParams", + "type": "tuple" + } + ], + "name": "sendFrom", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "_chainId", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "_configType", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "_config", + "type": "bytes" + } + ], + "name": "setConfig", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxDailyLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxDailyReceiveLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxSingleReceiveTransactionLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxSingleTransactionLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "_packetType", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "_minGas", + "type": "uint256" + } + ], + "name": "setMinDstGas", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "oracleAddress_", + "type": "address" + } + ], + "name": "setOracle", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "_size", + "type": "uint256" + } + ], + "name": "setPayloadSizeLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_precrime", + "type": "address" + } + ], + "name": "setPrecrime", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + } + ], + "name": "setReceiveVersion", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + } + ], + "name": "setSendVersion", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_path", + "type": "bytes" + } + ], + "name": "setTrustedRemote", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_remoteAddress", + "type": "bytes" + } + ], + "name": "setTrustedRemoteAddress", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user_", + "type": "address" + }, + { + "internalType": "bool", + "name": "val_", + "type": "bool" + } + ], + "name": "setWhitelist", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "sharedDecimals", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bytes4", + "name": "interfaceId", + "type": "bytes4" + } + ], + "name": "supportsInterface", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract IERC20", + "name": "token_", + "type": "address" + }, + { + "internalType": "address", + "name": "to_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "sweepToken", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "token", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "trustedRemoteLookup", + "outputs": [ + { + "internalType": "bytes", + "name": "", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "unpause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bool", + "name": "enabled_", + "type": "bool" + } + ], + "name": "updateSendAndCallEnabled", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "name": "whitelist", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + } + ], + "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "receipt": { + "to": null, + "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", + "contractAddress": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "transactionIndex": 1, + "gasUsed": "5402923", + "logsBloom": "0x00000000000000000000000200000000000000000004000400800000000000040000000000000000000010000000000008000000000000000000200000000000000000000000000000080000000000000001000020000000000000800000010000000000020000000000000000000800020000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080400000000000000000000000100000000000000010000000040000000000000000000000000000000000000000000000000000000000000000000000000020000000800000000000000000000000000000000000000000000000000000000000", + "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7", + "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "logs": [ + { + "transactionIndex": 1, + "blockNumber": 27104908, + "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "topics": [ + "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" + ], + "data": "0x", + "logIndex": 0, + "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7" + }, + { + "transactionIndex": 1, + "blockNumber": 27104908, + "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "topics": [ + "0x0b673f021ff9a27bbe58f282908695869e130b3103029190387b83650806c2c3", + "0x0000000000000000000000008f377098e488d227e809bd56d30c9fd8388245d3" + ], + "data": "0x", + "logIndex": 1, + "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7" + }, + { + "transactionIndex": 1, + "blockNumber": 27104908, + "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "topics": [ + "0x05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x0000000000000000000000006708bad042916b47311c8078b29d7f432342102f" + ], + "data": "0x", + "logIndex": 2, + "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7" + } + ], + "blockNumber": 27104908, + "cumulativeGasUsed": "5402923", + "status": 1, + "byzantium": true + }, + "args": [ + "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + 8, + "0x6098e96a28E02f27B1e6BD381f870F1C8Bd169d3", + "0x6708bAd042916B47311c8078b29d7f432342102F" + ], + "numDeployments": 1, + "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", + "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress_\",\"type\":\"address\"},{\"internalType\":\"uint8\",\"name\":\"sharedDecimals_\",\"type\":\"uint8\"},{\"internalType\":\"address\",\"name\":\"lzEndpoint_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"oracle_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"sweepAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"name\":\"InsufficientBalance\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"_hash\",\"type\":\"bytes32\"}],\"name\":\"CallOFTReceivedSuccess\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"srcChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"bytes\",\"name\":\"srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"nonce\",\"type\":\"uint64\"}],\"name\":\"DropFailedMessage\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"innerToken\",\"type\":\"address\"}],\"name\":\"InnerTokenAdded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_reason\",\"type\":\"bytes\"}],\"name\":\"MessageFailed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"NonContractAddress\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldOracle\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOracle\",\"type\":\"address\"}],\"name\":\"OracleChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"ReceiveFromChain\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"_payloadHash\",\"type\":\"bytes32\"}],\"name\":\"RetryMessageSuccess\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"SendToChain\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxDailyLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxDailyReceiveLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxSingleReceiveTransactionLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxSingleTransactionLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_type\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_minDstGas\",\"type\":\"uint256\"}],\"name\":\"SetMinDstGas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"precrime\",\"type\":\"address\"}],\"name\":\"SetPrecrime\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_path\",\"type\":\"bytes\"}],\"name\":\"SetTrustedRemote\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_remoteAddress\",\"type\":\"bytes\"}],\"name\":\"SetTrustedRemoteAddress\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"addr\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isWhitelist\",\"type\":\"bool\"}],\"name\":\"SetWhitelist\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"sweepAmount\",\"type\":\"uint256\"}],\"name\":\"SweepToken\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"}],\"name\":\"TrustedRemoteRemoved\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"UpdateSendAndCallEnabled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"DEFAULT_PAYLOAD_SIZE_LIMIT\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"NO_EXTRA_GAS\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"PT_SEND\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"PT_SEND_AND_CALL\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes32\",\"name\":\"_from\",\"type\":\"bytes32\"},{\"internalType\":\"address\",\"name\":\"_to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"_gasForCall\",\"type\":\"uint256\"}],\"name\":\"callOnOFTReceived\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourReceiveWindowStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourReceived\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourTransferred\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourWindowStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxDailyLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxDailyReceiveLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxSingleReceiveTransactionLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxSingleTransactionLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"circulatingSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"creditedPackets\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"srcChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"srcAddress_\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"nonce_\",\"type\":\"uint64\"}],\"name\":\"dropFailedMessage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_dstGasForCall\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"_useZro\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"_adapterParams\",\"type\":\"bytes\"}],\"name\":\"estimateSendAndCallFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"nativeFee\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"zroFee\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"_useZro\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"_adapterParams\",\"type\":\"bytes\"}],\"name\":\"estimateSendFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"nativeFee\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"zroFee\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"failedMessages\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"}],\"name\":\"forceResumeReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_chainId\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_configType\",\"type\":\"uint256\"}],\"name\":\"getConfig\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"}],\"name\":\"getTrustedRemoteAddress\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from_\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"dstChainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"isEligibleToSend\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"eligibleToSend\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"maxSingleTransactionLimit\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"maxDailyLimit\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"amountInUsd\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"transferredInWindow\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"last24HourWindowStart\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"isWhiteListedUser\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"lzEndpoint\",\"outputs\":[{\"internalType\":\"contract ILayerZeroEndpoint\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"lzReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"minDstGasLookup\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"nonblockingLzReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"oracle\",\"outputs\":[{\"internalType\":\"contract ResilientOracleInterface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"payloadSizeLimitLookup\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"precrime\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"}],\"name\":\"removeTrustedRemote\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"retryMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from_\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"dstChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"toAddress_\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"payload_\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"dstGasForCall_\",\"type\":\"uint64\"},{\"components\":[{\"internalType\":\"address payable\",\"name\":\"refundAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"zroPaymentAddress\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"adapterParams\",\"type\":\"bytes\"}],\"internalType\":\"struct ICommonOFT.LzCallParams\",\"name\":\"callparams_\",\"type\":\"tuple\"}],\"name\":\"sendAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"sendAndCallEnabled\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_from\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"address payable\",\"name\":\"refundAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"zroPaymentAddress\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"adapterParams\",\"type\":\"bytes\"}],\"internalType\":\"struct ICommonOFT.LzCallParams\",\"name\":\"_callParams\",\"type\":\"tuple\"}],\"name\":\"sendFrom\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_chainId\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_configType\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_config\",\"type\":\"bytes\"}],\"name\":\"setConfig\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxDailyLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxDailyReceiveLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxSingleReceiveTransactionLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxSingleTransactionLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_packetType\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_minGas\",\"type\":\"uint256\"}],\"name\":\"setMinDstGas\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"oracleAddress_\",\"type\":\"address\"}],\"name\":\"setOracle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_size\",\"type\":\"uint256\"}],\"name\":\"setPayloadSizeLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_precrime\",\"type\":\"address\"}],\"name\":\"setPrecrime\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"}],\"name\":\"setReceiveVersion\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"}],\"name\":\"setSendVersion\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_path\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemote\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_remoteAddress\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"val_\",\"type\":\"bool\"}],\"name\":\"setWhitelist\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"sharedDecimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"interfaceId\",\"type\":\"bytes4\"}],\"name\":\"supportsInterface\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"token_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"sweepToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"token\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"trustedRemoteLookup\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"unpause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"enabled_\",\"type\":\"bool\"}],\"name\":\"updateSendAndCallEnabled\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"whitelist\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"circulatingSupply()\":{\"returns\":{\"_0\":\"total circulating supply of the token on the destination chain.\"}},\"dropFailedMessage(uint16,bytes,uint64)\":{\"custom:access\":\"Only owner\",\"custom:event\":\"Emits DropFailedMessage on clearance of failed message.\",\"params\":{\"nonce_\":\"Nonce_ of the transaction\",\"srcAddress_\":\"Address of source followed by current bridge address\",\"srcChainId_\":\"Chain id of source\"}},\"estimateSendFee(uint16,bytes32,uint256,bool,bytes)\":{\"details\":\"estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`) _dstChainId - L0 defined chain id to send tokens too _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain _amount - amount of the tokens to transfer _useZro - indicates to use zro to pay L0 fees _adapterParam - flexible bytes array to indicate messaging adapter services in L0\"},\"isEligibleToSend(address,uint16,uint256)\":{\"details\":\"This external view function assesses whether the specified sender is eligible to transfer the given amount to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\",\"params\":{\"amount_\":\"The quantity of tokens to be transferred.\",\"dstChainId_\":\"Indicates destination chain.\",\"from_\":\"The sender's address initiating the transfer.\"},\"returns\":{\"amountInUsd\":\"The equivalent amount in USD based on the oracle price.\",\"eligibleToSend\":\"A boolean indicating whether the sender is eligible to transfer the tokens.\",\"isWhiteListedUser\":\"A boolean indicating whether the sender is whitelisted.\",\"last24HourWindowStart\":\"The timestamp when the current 24-hour window started.\",\"maxDailyLimit\":\"The maximum daily limit for transactions.\",\"maxSingleTransactionLimit\":\"The maximum limit for a single transaction.\",\"transferredInWindow\":\"The total amount transferred in the current 24-hour window.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pause()\":{\"custom:access\":\"Only owner.\"},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"removeTrustedRemote(uint16)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\",\"params\":{\"remoteChainId_\":\"The chain's id corresponds to setting the trusted remote to empty.\"}},\"sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))\":{\"details\":\"This internal override function enables the contract to send tokens and invoke calls on the specified destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\",\"params\":{\"amount_\":\"Amount of tokens that will be transferred.\",\"callparams_\":\"Additional parameters, including refund address, ZRO payment address, and adapter params.\",\"dstChainId_\":\"Destination chain id on which tokens will be send.\",\"dstGasForCall_\":\"The amount of gas allocated for the call on the destination chain.\",\"from_\":\"Address from which tokens will be debited.\",\"payload_\":\"Additional data payload for the call on the destination chain.\",\"toAddress_\":\"Address on which tokens will be credited on destination chain.\"}},\"sendFrom(address,uint16,bytes32,uint256,(address,address,bytes))\":{\"details\":\"send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from` `_from` the owner of token `_dstChainId` the destination chain identifier `_toAddress` can be any size depending on the `dstChainId`. `_amount` the quantity of tokens in wei `_refundAddress` the address LayerZero refunds if too much message fee is sent `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token) `_adapterParams` is a flexible bytes array to indicate messaging adapter services\"},\"setMaxDailyLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxDailyLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"Destination chain id.\",\"limit_\":\"Amount in USD(scaled with 18 decimals).\"}},\"setMaxDailyReceiveLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"The destination chain ID.\",\"limit_\":\"The new maximum daily limit in USD(scaled with 18 decimals).\"}},\"setMaxSingleReceiveTransactionLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"The destination chain ID.\",\"limit_\":\"The new maximum limit in USD(scaled with 18 decimals).\"}},\"setMaxSingleTransactionLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"Destination chain id.\",\"limit_\":\"Amount in USD(scaled with 18 decimals).\"}},\"setOracle(address)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits OracleChanged with old and new oracle address.\",\"details\":\"Reverts if the new address is zero.\",\"params\":{\"oracleAddress_\":\"The new address of the ResilientOracle contract.\"}},\"setWhitelist(address,bool)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setWhitelist.\",\"params\":{\"user_\":\"Address to be add in whitelist.\",\"val_\":\"Boolean to be set (true for user_ address is whitelisted).\"}},\"sweepToken(address,address,uint256)\":{\"custom:access\":\"Only Owner\",\"custom:error\":\"Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\",\"custom:event\":\"Emits SweepToken event\",\"params\":{\"amount_\":\"The amount of tokens needs to transfer\",\"to_\":\"The address of the recipient\",\"token_\":\"The address of the ERC-20 token to sweep\"}},\"token()\":{\"returns\":{\"_0\":\"Address of the inner token of this bridge.\"}},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"unpause()\":{\"custom:access\":\"Only owner.\"},\"updateSendAndCallEnabled(bool)\":{\"params\":{\"enabled_\":\"Boolean indicating whether the sendAndCall function should be enabled or disabled.\"}}},\"title\":\"XVSProxyOFTDest\",\"version\":1},\"userdoc\":{\"errors\":{\"InsufficientBalance(uint256,uint256)\":[{\"notice\":\"Error thrown when this contract balance is less than sweep amount\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"DropFailedMessage(uint16,bytes,uint64)\":{\"notice\":\"Emits when stored message dropped without successful retrying.\"},\"InnerTokenAdded(address)\":{\"notice\":\"Event emitted when inner token set successfully.\"},\"OracleChanged(address,address)\":{\"notice\":\"Event emitted when oracle is modified.\"},\"SetMaxDailyLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum daily limit of transactions from local chain is modified.\"},\"SetMaxDailyReceiveLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\"},\"SetMaxSingleReceiveTransactionLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum limit for a single receive transaction from remote chain is modified.\"},\"SetMaxSingleTransactionLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum limit for a single transaction from local chain is modified.\"},\"SetWhitelist(address,bool)\":{\"notice\":\"Emitted when address is added to whitelist.\"},\"SweepToken(address,address,uint256)\":{\"notice\":\"Emitted on sweep token success\"},\"TrustedRemoteRemoved(uint16)\":{\"notice\":\"Event emitted when trusted remote sets to empty.\"},\"UpdateSendAndCallEnabled(bool)\":{\"notice\":\"Event emitted when SendAndCallEnabled updated successfully.\"}},\"kind\":\"user\",\"methods\":{\"chainIdToLast24HourReceiveWindowStart(uint16)\":{\"notice\":\"Timestamp when the last 24-hour window started from remote chain.\"},\"chainIdToLast24HourReceived(uint16)\":{\"notice\":\"Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\"},\"chainIdToLast24HourTransferred(uint16)\":{\"notice\":\"Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\"},\"chainIdToLast24HourWindowStart(uint16)\":{\"notice\":\"Timestamp when the last 24-hour window started from local chain.\"},\"chainIdToMaxDailyLimit(uint16)\":{\"notice\":\"Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\"},\"chainIdToMaxDailyReceiveLimit(uint16)\":{\"notice\":\"Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\"},\"chainIdToMaxSingleReceiveTransactionLimit(uint16)\":{\"notice\":\"Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\"},\"chainIdToMaxSingleTransactionLimit(uint16)\":{\"notice\":\"Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\"},\"circulatingSupply()\":{\"notice\":\"Returns the total circulating supply of the token on the destination chain i.e (total supply).\"},\"dropFailedMessage(uint16,bytes,uint64)\":{\"notice\":\"Clear failed messages from the storage.\"},\"isEligibleToSend(address,uint16,uint256)\":{\"notice\":\"Checks the eligibility of a sender to initiate a cross-chain token transfer.\"},\"oracle()\":{\"notice\":\"The address of ResilientOracle contract wrapped in its interface.\"},\"pause()\":{\"notice\":\"Triggers stopped state of the bridge.\"},\"removeTrustedRemote(uint16)\":{\"notice\":\"Remove trusted remote from storage.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))\":{\"notice\":\"Initiates a cross-chain token transfer and triggers a call on the destination chain.\"},\"setMaxDailyLimit(uint16,uint256)\":{\"notice\":\"Sets the limit of daily (24 Hour) transactions amount.\"},\"setMaxDailyReceiveLimit(uint16,uint256)\":{\"notice\":\"Sets the maximum daily limit for receiving transactions.\"},\"setMaxSingleReceiveTransactionLimit(uint16,uint256)\":{\"notice\":\"Sets the maximum limit for a single receive transaction.\"},\"setMaxSingleTransactionLimit(uint16,uint256)\":{\"notice\":\"Sets the limit of single transaction amount.\"},\"setOracle(address)\":{\"notice\":\"Set the address of the ResilientOracle contract.\"},\"setWhitelist(address,bool)\":{\"notice\":\"Sets the whitelist address to skip checks on transaction limit.\"},\"sweepToken(address,address,uint256)\":{\"notice\":\"A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\"},\"token()\":{\"notice\":\"Return's the address of the inner token of this bridge.\"},\"unpause()\":{\"notice\":\"Triggers resume state of the bridge.\"},\"updateSendAndCallEnabled(bool)\":{\"notice\":\"It enables or disables sendAndCall functionality for the bridge.\"},\"whitelist(address)\":{\"notice\":\"Address on which cap check and bound limit is not applicable.\"}},\"notice\":\"XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT, and focuses on managing token transfers to the destination chain. It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSProxyOFTDest.sol\":\"XVSProxyOFTDest\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@layerzerolabs/solidity-examples/contracts/libraries/BytesLib.sol\":{\"content\":\"// SPDX-License-Identifier: Unlicense\\n/*\\n * @title Solidity Bytes Arrays Utils\\n * @author Gon\\u00e7alo S\\u00e1 \\n *\\n * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.\\n * The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.\\n */\\npragma solidity >=0.8.0 <0.9.0;\\n\\nlibrary BytesLib {\\n function concat(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bytes memory) {\\n bytes memory tempBytes;\\n\\n assembly {\\n // Get a location of some free memory and store it in tempBytes as\\n // Solidity does for memory variables.\\n tempBytes := mload(0x40)\\n\\n // Store the length of the first bytes array at the beginning of\\n // the memory for tempBytes.\\n let length := mload(_preBytes)\\n mstore(tempBytes, length)\\n\\n // Maintain a memory counter for the current write location in the\\n // temp bytes array by adding the 32 bytes for the array length to\\n // the starting location.\\n let mc := add(tempBytes, 0x20)\\n // Stop copying when the memory counter reaches the length of the\\n // first bytes array.\\n let end := add(mc, length)\\n\\n for {\\n // Initialize a copy counter to the start of the _preBytes data,\\n // 32 bytes into its memory.\\n let cc := add(_preBytes, 0x20)\\n } lt(mc, end) {\\n // Increase both counters by 32 bytes each iteration.\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n // Write the _preBytes data into the tempBytes memory 32 bytes\\n // at a time.\\n mstore(mc, mload(cc))\\n }\\n\\n // Add the length of _postBytes to the current length of tempBytes\\n // and store it as the new length in the first 32 bytes of the\\n // tempBytes memory.\\n length := mload(_postBytes)\\n mstore(tempBytes, add(length, mload(tempBytes)))\\n\\n // Move the memory counter back from a multiple of 0x20 to the\\n // actual end of the _preBytes data.\\n mc := end\\n // Stop copying when the memory counter reaches the new combined\\n // length of the arrays.\\n end := add(mc, length)\\n\\n for {\\n let cc := add(_postBytes, 0x20)\\n } lt(mc, end) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n mstore(mc, mload(cc))\\n }\\n\\n // Update the free-memory pointer by padding our last write location\\n // to 32 bytes: add 31 bytes to the end of tempBytes to move to the\\n // next 32 byte block, then round down to the nearest multiple of\\n // 32. If the sum of the length of the two arrays is zero then add\\n // one before rounding down to leave a blank 32 bytes (the length block with 0).\\n mstore(\\n 0x40,\\n and(\\n add(add(end, iszero(add(length, mload(_preBytes)))), 31),\\n not(31) // Round down to the nearest 32 bytes.\\n )\\n )\\n }\\n\\n return tempBytes;\\n }\\n\\n function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {\\n assembly {\\n // Read the first 32 bytes of _preBytes storage, which is the length\\n // of the array. (We don't need to use the offset into the slot\\n // because arrays use the entire slot.)\\n let fslot := sload(_preBytes.slot)\\n // Arrays of 31 bytes or less have an even value in their slot,\\n // while longer arrays have an odd value. The actual length is\\n // the slot divided by two for odd values, and the lowest order\\n // byte divided by two for even values.\\n // If the slot is even, bitwise and the slot with 255 and divide by\\n // two to get the length. If the slot is odd, bitwise and the slot\\n // with -1 and divide by two.\\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\\n let mlength := mload(_postBytes)\\n let newlength := add(slength, mlength)\\n // slength can contain both the length and contents of the array\\n // if length < 32 bytes so let's prepare for that\\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\\n switch add(lt(slength, 32), lt(newlength, 32))\\n case 2 {\\n // Since the new array still fits in the slot, we just need to\\n // update the contents of the slot.\\n // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length\\n sstore(\\n _preBytes.slot,\\n // all the modifications to the slot are inside this\\n // next block\\n add(\\n // we can just add to the slot contents because the\\n // bytes we want to change are the LSBs\\n fslot,\\n add(\\n mul(\\n div(\\n // load the bytes from memory\\n mload(add(_postBytes, 0x20)),\\n // zero all bytes to the right\\n exp(0x100, sub(32, mlength))\\n ),\\n // and now shift left the number of bytes to\\n // leave space for the length in the slot\\n exp(0x100, sub(32, newlength))\\n ),\\n // increase length by the double of the memory\\n // bytes length\\n mul(mlength, 2)\\n )\\n )\\n )\\n }\\n case 1 {\\n // The stored value fits in the slot, but the combined value\\n // will exceed it.\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\\n\\n // save new length\\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\\n\\n // The contents of the _postBytes array start 32 bytes into\\n // the structure. Our first read should obtain the `submod`\\n // bytes that can fit into the unused space in the last word\\n // of the stored array. To get this, we read 32 bytes starting\\n // from `submod`, so the data we read overlaps with the array\\n // contents by `submod` bytes. Masking the lowest-order\\n // `submod` bytes allows us to add that value directly to the\\n // stored value.\\n\\n let submod := sub(32, slength)\\n let mc := add(_postBytes, submod)\\n let end := add(_postBytes, mlength)\\n let mask := sub(exp(0x100, submod), 1)\\n\\n sstore(sc, add(and(fslot, 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00), and(mload(mc), mask)))\\n\\n for {\\n mc := add(mc, 0x20)\\n sc := add(sc, 1)\\n } lt(mc, end) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n sstore(sc, mload(mc))\\n }\\n\\n mask := exp(0x100, sub(mc, end))\\n\\n sstore(sc, mul(div(mload(mc), mask), mask))\\n }\\n default {\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n // Start copying to the last used word of the stored array.\\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\\n\\n // save new length\\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\\n\\n // Copy over the first `submod` bytes of the new data as in\\n // case 1 above.\\n let slengthmod := mod(slength, 32)\\n let mlengthmod := mod(mlength, 32)\\n let submod := sub(32, slengthmod)\\n let mc := add(_postBytes, submod)\\n let end := add(_postBytes, mlength)\\n let mask := sub(exp(0x100, submod), 1)\\n\\n sstore(sc, add(sload(sc), and(mload(mc), mask)))\\n\\n for {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } lt(mc, end) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n sstore(sc, mload(mc))\\n }\\n\\n mask := exp(0x100, sub(mc, end))\\n\\n sstore(sc, mul(div(mload(mc), mask), mask))\\n }\\n }\\n }\\n\\n function slice(\\n bytes memory _bytes,\\n uint _start,\\n uint _length\\n ) internal pure returns (bytes memory) {\\n require(_length + 31 >= _length, \\\"slice_overflow\\\");\\n require(_bytes.length >= _start + _length, \\\"slice_outOfBounds\\\");\\n\\n bytes memory tempBytes;\\n\\n assembly {\\n switch iszero(_length)\\n case 0 {\\n // Get a location of some free memory and store it in tempBytes as\\n // Solidity does for memory variables.\\n tempBytes := mload(0x40)\\n\\n // The first word of the slice result is potentially a partial\\n // word read from the original array. To read it, we calculate\\n // the length of that partial word and start copying that many\\n // bytes into the array. The first word we copy will start with\\n // data we don't care about, but the last `lengthmod` bytes will\\n // land at the beginning of the contents of the new array. When\\n // we're done copying, we overwrite the full first word with\\n // the actual length of the slice.\\n let lengthmod := and(_length, 31)\\n\\n // The multiplication in the next line is necessary\\n // because when slicing multiples of 32 bytes (lengthmod == 0)\\n // the following copy loop was copying the origin's length\\n // and then ending prematurely not copying everything it should.\\n let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))\\n let end := add(mc, _length)\\n\\n for {\\n // The multiplication in the next line has the same exact purpose\\n // as the one above.\\n let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)\\n } lt(mc, end) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n mstore(mc, mload(cc))\\n }\\n\\n mstore(tempBytes, _length)\\n\\n //update free-memory pointer\\n //allocating the array padded to 32 bytes like the compiler does now\\n mstore(0x40, and(add(mc, 31), not(31)))\\n }\\n //if we want a zero-length slice let's just return a zero-length array\\n default {\\n tempBytes := mload(0x40)\\n //zero out the 32 bytes slice we are about to return\\n //we need to do it because Solidity does not garbage collect\\n mstore(tempBytes, 0)\\n\\n mstore(0x40, add(tempBytes, 0x20))\\n }\\n }\\n\\n return tempBytes;\\n }\\n\\n function toAddress(bytes memory _bytes, uint _start) internal pure returns (address) {\\n require(_bytes.length >= _start + 20, \\\"toAddress_outOfBounds\\\");\\n address tempAddress;\\n\\n assembly {\\n tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)\\n }\\n\\n return tempAddress;\\n }\\n\\n function toUint8(bytes memory _bytes, uint _start) internal pure returns (uint8) {\\n require(_bytes.length >= _start + 1, \\\"toUint8_outOfBounds\\\");\\n uint8 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x1), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint16(bytes memory _bytes, uint _start) internal pure returns (uint16) {\\n require(_bytes.length >= _start + 2, \\\"toUint16_outOfBounds\\\");\\n uint16 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x2), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint32(bytes memory _bytes, uint _start) internal pure returns (uint32) {\\n require(_bytes.length >= _start + 4, \\\"toUint32_outOfBounds\\\");\\n uint32 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x4), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint64(bytes memory _bytes, uint _start) internal pure returns (uint64) {\\n require(_bytes.length >= _start + 8, \\\"toUint64_outOfBounds\\\");\\n uint64 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x8), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint96(bytes memory _bytes, uint _start) internal pure returns (uint96) {\\n require(_bytes.length >= _start + 12, \\\"toUint96_outOfBounds\\\");\\n uint96 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0xc), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint128(bytes memory _bytes, uint _start) internal pure returns (uint128) {\\n require(_bytes.length >= _start + 16, \\\"toUint128_outOfBounds\\\");\\n uint128 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x10), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint256(bytes memory _bytes, uint _start) internal pure returns (uint) {\\n require(_bytes.length >= _start + 32, \\\"toUint256_outOfBounds\\\");\\n uint tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x20), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toBytes32(bytes memory _bytes, uint _start) internal pure returns (bytes32) {\\n require(_bytes.length >= _start + 32, \\\"toBytes32_outOfBounds\\\");\\n bytes32 tempBytes32;\\n\\n assembly {\\n tempBytes32 := mload(add(add(_bytes, 0x20), _start))\\n }\\n\\n return tempBytes32;\\n }\\n\\n function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {\\n bool success = true;\\n\\n assembly {\\n let length := mload(_preBytes)\\n\\n // if lengths don't match the arrays are not equal\\n switch eq(length, mload(_postBytes))\\n case 1 {\\n // cb is a circuit breaker in the for loop since there's\\n // no said feature for inline assembly loops\\n // cb = 1 - don't breaker\\n // cb = 0 - break\\n let cb := 1\\n\\n let mc := add(_preBytes, 0x20)\\n let end := add(mc, length)\\n\\n for {\\n let cc := add(_postBytes, 0x20)\\n // the next line is the loop condition:\\n // while(uint256(mc < end) + cb == 2)\\n } eq(add(lt(mc, end), cb), 2) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n // if any of these checks fails then arrays are not equal\\n if iszero(eq(mload(mc), mload(cc))) {\\n // unsuccess:\\n success := 0\\n cb := 0\\n }\\n }\\n }\\n default {\\n // unsuccess:\\n success := 0\\n }\\n }\\n\\n return success;\\n }\\n\\n function equalStorage(bytes storage _preBytes, bytes memory _postBytes) internal view returns (bool) {\\n bool success = true;\\n\\n assembly {\\n // we know _preBytes_offset is 0\\n let fslot := sload(_preBytes.slot)\\n // Decode the length of the stored array like in concatStorage().\\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\\n let mlength := mload(_postBytes)\\n\\n // if lengths don't match the arrays are not equal\\n switch eq(slength, mlength)\\n case 1 {\\n // slength can contain both the length and contents of the array\\n // if length < 32 bytes so let's prepare for that\\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\\n if iszero(iszero(slength)) {\\n switch lt(slength, 32)\\n case 1 {\\n // blank the last byte which is the length\\n fslot := mul(div(fslot, 0x100), 0x100)\\n\\n if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {\\n // unsuccess:\\n success := 0\\n }\\n }\\n default {\\n // cb is a circuit breaker in the for loop since there's\\n // no said feature for inline assembly loops\\n // cb = 1 - don't breaker\\n // cb = 0 - break\\n let cb := 1\\n\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n let sc := keccak256(0x0, 0x20)\\n\\n let mc := add(_postBytes, 0x20)\\n let end := add(mc, mlength)\\n\\n // the next line is the loop condition:\\n // while(uint256(mc < end) + cb == 2)\\n for {\\n\\n } eq(add(lt(mc, end), cb), 2) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n if iszero(eq(sload(sc), mload(mc))) {\\n // unsuccess:\\n success := 0\\n cb := 0\\n }\\n }\\n }\\n }\\n }\\n default {\\n // unsuccess:\\n success := 0\\n }\\n }\\n\\n return success;\\n }\\n}\\n\",\"keccak256\":\"0x7e64cccdf22a03f513d94960f2145dd801fb5ec88d971de079b5186a9f5e93c4\",\"license\":\"Unlicense\"},\"@layerzerolabs/solidity-examples/contracts/libraries/ExcessivelySafeCall.sol\":{\"content\":\"// SPDX-License-Identifier: MIT OR Apache-2.0\\npragma solidity >=0.7.6;\\n\\nlibrary ExcessivelySafeCall {\\n uint constant LOW_28_MASK = 0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;\\n\\n /// @notice Use when you _really_ really _really_ don't trust the called\\n /// contract. This prevents the called contract from causing reversion of\\n /// the caller in as many ways as we can.\\n /// @dev The main difference between this and a solidity low-level call is\\n /// that we limit the number of bytes that the callee can cause to be\\n /// copied to caller memory. This prevents stupid things like malicious\\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\\n /// to memory.\\n /// @param _target The address to call\\n /// @param _gas The amount of gas to forward to the remote contract\\n /// @param _maxCopy The maximum number of bytes of returndata to copy\\n /// to memory.\\n /// @param _calldata The data to send to the remote contract\\n /// @return success and returndata, as `.call()`. Returndata is capped to\\n /// `_maxCopy` bytes.\\n function excessivelySafeCall(\\n address _target,\\n uint _gas,\\n uint16 _maxCopy,\\n bytes memory _calldata\\n ) internal returns (bool, bytes memory) {\\n // set up for assembly call\\n uint _toCopy;\\n bool _success;\\n bytes memory _returnData = new bytes(_maxCopy);\\n // dispatch message to recipient\\n // by assembly calling \\\"handle\\\" function\\n // we call via assembly to avoid memcopying a very large returndata\\n // returned by a malicious contract\\n assembly {\\n _success := call(\\n _gas, // gas\\n _target, // recipient\\n 0, // ether value\\n add(_calldata, 0x20), // inloc\\n mload(_calldata), // inlen\\n 0, // outloc\\n 0 // outlen\\n )\\n // limit our copy to 256 bytes\\n _toCopy := returndatasize()\\n if gt(_toCopy, _maxCopy) {\\n _toCopy := _maxCopy\\n }\\n // Store the length of the copied bytes\\n mstore(_returnData, _toCopy)\\n // copy the bytes from returndata[0:_toCopy]\\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\\n }\\n return (_success, _returnData);\\n }\\n\\n /// @notice Use when you _really_ really _really_ don't trust the called\\n /// contract. This prevents the called contract from causing reversion of\\n /// the caller in as many ways as we can.\\n /// @dev The main difference between this and a solidity low-level call is\\n /// that we limit the number of bytes that the callee can cause to be\\n /// copied to caller memory. This prevents stupid things like malicious\\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\\n /// to memory.\\n /// @param _target The address to call\\n /// @param _gas The amount of gas to forward to the remote contract\\n /// @param _maxCopy The maximum number of bytes of returndata to copy\\n /// to memory.\\n /// @param _calldata The data to send to the remote contract\\n /// @return success and returndata, as `.call()`. Returndata is capped to\\n /// `_maxCopy` bytes.\\n function excessivelySafeStaticCall(\\n address _target,\\n uint _gas,\\n uint16 _maxCopy,\\n bytes memory _calldata\\n ) internal view returns (bool, bytes memory) {\\n // set up for assembly call\\n uint _toCopy;\\n bool _success;\\n bytes memory _returnData = new bytes(_maxCopy);\\n // dispatch message to recipient\\n // by assembly calling \\\"handle\\\" function\\n // we call via assembly to avoid memcopying a very large returndata\\n // returned by a malicious contract\\n assembly {\\n _success := staticcall(\\n _gas, // gas\\n _target, // recipient\\n add(_calldata, 0x20), // inloc\\n mload(_calldata), // inlen\\n 0, // outloc\\n 0 // outlen\\n )\\n // limit our copy to 256 bytes\\n _toCopy := returndatasize()\\n if gt(_toCopy, _maxCopy) {\\n _toCopy := _maxCopy\\n }\\n // Store the length of the copied bytes\\n mstore(_returnData, _toCopy)\\n // copy the bytes from returndata[0:_toCopy]\\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\\n }\\n return (_success, _returnData);\\n }\\n\\n /**\\n * @notice Swaps function selectors in encoded contract calls\\n * @dev Allows reuse of encoded calldata for functions with identical\\n * argument types but different names. It simply swaps out the first 4 bytes\\n * for the new selector. This function modifies memory in place, and should\\n * only be used with caution.\\n * @param _newSelector The new 4-byte selector\\n * @param _buf The encoded contract args\\n */\\n function swapSelector(bytes4 _newSelector, bytes memory _buf) internal pure {\\n require(_buf.length >= 4);\\n uint _mask = LOW_28_MASK;\\n assembly {\\n // load the first word of\\n let _word := mload(add(_buf, 0x20))\\n // mask out the top 4 bytes\\n // /x\\n _word := and(_word, _mask)\\n _word := or(_newSelector, _word)\\n mstore(add(_buf, 0x20), _word)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xd4e52af409b5ec80432292d86fb01906785eb78ac31da3bab4565aabcd6e3e56\",\"license\":\"MIT OR Apache-2.0\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/LzApp.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\nimport \\\"./interfaces/ILayerZeroReceiver.sol\\\";\\nimport \\\"./interfaces/ILayerZeroUserApplicationConfig.sol\\\";\\nimport \\\"./interfaces/ILayerZeroEndpoint.sol\\\";\\nimport \\\"../libraries/BytesLib.sol\\\";\\n\\n/*\\n * a generic LzReceiver implementation\\n */\\nabstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {\\n using BytesLib for bytes;\\n\\n // ua can not send payload larger than this by default, but it can be changed by the ua owner\\n uint public constant DEFAULT_PAYLOAD_SIZE_LIMIT = 10000;\\n\\n ILayerZeroEndpoint public immutable lzEndpoint;\\n mapping(uint16 => bytes) public trustedRemoteLookup;\\n mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;\\n mapping(uint16 => uint) public payloadSizeLimitLookup;\\n address public precrime;\\n\\n event SetPrecrime(address precrime);\\n event SetTrustedRemote(uint16 _remoteChainId, bytes _path);\\n event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);\\n event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);\\n\\n constructor(address _endpoint) {\\n lzEndpoint = ILayerZeroEndpoint(_endpoint);\\n }\\n\\n function lzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public virtual override {\\n // lzReceive must be called by the endpoint for security\\n require(_msgSender() == address(lzEndpoint), \\\"LzApp: invalid endpoint caller\\\");\\n\\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\\n // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\\n require(\\n _srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote),\\n \\\"LzApp: invalid source sending contract\\\"\\n );\\n\\n _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging\\n function _blockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual;\\n\\n function _lzSend(\\n uint16 _dstChainId,\\n bytes memory _payload,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams,\\n uint _nativeFee\\n ) internal virtual {\\n bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];\\n require(trustedRemote.length != 0, \\\"LzApp: destination chain is not a trusted source\\\");\\n _checkPayloadSize(_dstChainId, _payload.length);\\n lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);\\n }\\n\\n function _checkGasLimit(\\n uint16 _dstChainId,\\n uint16 _type,\\n bytes memory _adapterParams,\\n uint _extraGas\\n ) internal view virtual {\\n uint providedGasLimit = _getGasLimit(_adapterParams);\\n uint minGasLimit = minDstGasLookup[_dstChainId][_type];\\n require(minGasLimit > 0, \\\"LzApp: minGasLimit not set\\\");\\n require(providedGasLimit >= minGasLimit + _extraGas, \\\"LzApp: gas limit is too low\\\");\\n }\\n\\n function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {\\n require(_adapterParams.length >= 34, \\\"LzApp: invalid adapterParams\\\");\\n assembly {\\n gasLimit := mload(add(_adapterParams, 34))\\n }\\n }\\n\\n function _checkPayloadSize(uint16 _dstChainId, uint _payloadSize) internal view virtual {\\n uint payloadSizeLimit = payloadSizeLimitLookup[_dstChainId];\\n if (payloadSizeLimit == 0) {\\n // use default if not set\\n payloadSizeLimit = DEFAULT_PAYLOAD_SIZE_LIMIT;\\n }\\n require(_payloadSize <= payloadSizeLimit, \\\"LzApp: payload size is too large\\\");\\n }\\n\\n //---------------------------UserApplication config----------------------------------------\\n function getConfig(\\n uint16 _version,\\n uint16 _chainId,\\n address,\\n uint _configType\\n ) external view returns (bytes memory) {\\n return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);\\n }\\n\\n // generic config for LayerZero user Application\\n function setConfig(\\n uint16 _version,\\n uint16 _chainId,\\n uint _configType,\\n bytes calldata _config\\n ) external override onlyOwner {\\n lzEndpoint.setConfig(_version, _chainId, _configType, _config);\\n }\\n\\n function setSendVersion(uint16 _version) external override onlyOwner {\\n lzEndpoint.setSendVersion(_version);\\n }\\n\\n function setReceiveVersion(uint16 _version) external override onlyOwner {\\n lzEndpoint.setReceiveVersion(_version);\\n }\\n\\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {\\n lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);\\n }\\n\\n // _path = abi.encodePacked(remoteAddress, localAddress)\\n // this function set the trusted path for the cross-chain communication\\n function setTrustedRemote(uint16 _remoteChainId, bytes calldata _path) external onlyOwner {\\n trustedRemoteLookup[_remoteChainId] = _path;\\n emit SetTrustedRemote(_remoteChainId, _path);\\n }\\n\\n function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {\\n trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));\\n emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);\\n }\\n\\n function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {\\n bytes memory path = trustedRemoteLookup[_remoteChainId];\\n require(path.length != 0, \\\"LzApp: no trusted path record\\\");\\n return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)\\n }\\n\\n function setPrecrime(address _precrime) external onlyOwner {\\n precrime = _precrime;\\n emit SetPrecrime(_precrime);\\n }\\n\\n function setMinDstGas(\\n uint16 _dstChainId,\\n uint16 _packetType,\\n uint _minGas\\n ) external onlyOwner {\\n minDstGasLookup[_dstChainId][_packetType] = _minGas;\\n emit SetMinDstGas(_dstChainId, _packetType, _minGas);\\n }\\n\\n // if the size is 0, it means default size limit\\n function setPayloadSizeLimit(uint16 _dstChainId, uint _size) external onlyOwner {\\n payloadSizeLimitLookup[_dstChainId] = _size;\\n }\\n\\n //--------------------------- VIEW FUNCTION ----------------------------------------\\n function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {\\n bytes memory trustedSource = trustedRemoteLookup[_srcChainId];\\n return keccak256(trustedSource) == keccak256(_srcAddress);\\n }\\n}\\n\",\"keccak256\":\"0x309c994bdcf69ad63c6789694a28eb72a773e2d9db58fe572ab2b34a475972ce\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/NonblockingLzApp.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./LzApp.sol\\\";\\nimport \\\"../libraries/ExcessivelySafeCall.sol\\\";\\n\\n/*\\n * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel\\n * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking\\n * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)\\n */\\nabstract contract NonblockingLzApp is LzApp {\\n using ExcessivelySafeCall for address;\\n\\n constructor(address _endpoint) LzApp(_endpoint) {}\\n\\n mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;\\n\\n event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);\\n event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);\\n\\n // overriding the virtual function in LzReceiver\\n function _blockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual override {\\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\\n gasleft(),\\n 150,\\n abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload)\\n );\\n // try-catch all errors/exceptions\\n if (!success) {\\n _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);\\n }\\n }\\n\\n function _storeFailedMessage(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload,\\n bytes memory _reason\\n ) internal virtual {\\n failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);\\n emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);\\n }\\n\\n function nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public virtual {\\n // only internal transaction\\n require(_msgSender() == address(this), \\\"NonblockingLzApp: caller must be LzApp\\\");\\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n //@notice override this function\\n function _nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual;\\n\\n function retryMessage(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public payable virtual {\\n // assert there is message to retry\\n bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];\\n require(payloadHash != bytes32(0), \\\"NonblockingLzApp: no stored message\\\");\\n require(keccak256(_payload) == payloadHash, \\\"NonblockingLzApp: invalid payload\\\");\\n // clear the stored message\\n failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);\\n // execute the message. revert if it fails again\\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);\\n }\\n}\\n\",\"keccak256\":\"0x612ff1f2a158b7e64e873885b5ff08afa348998fd9005f384d555d643ba7968d\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroEndpoint.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"./ILayerZeroUserApplicationConfig.sol\\\";\\n\\ninterface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {\\n // @notice send a LayerZero message to the specified address at a LayerZero endpoint.\\n // @param _dstChainId - the destination chain identifier\\n // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains\\n // @param _payload - a custom bytes payload to send to the destination contract\\n // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address\\n // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction\\n // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination\\n function send(\\n uint16 _dstChainId,\\n bytes calldata _destination,\\n bytes calldata _payload,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes calldata _adapterParams\\n ) external payable;\\n\\n // @notice used by the messaging library to publish verified payload\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source contract (as bytes) at the source chain\\n // @param _dstAddress - the address on destination chain\\n // @param _nonce - the unbound message ordering nonce\\n // @param _gasLimit - the gas limit for external contract execution\\n // @param _payload - verified payload to send to the destination contract\\n function receivePayload(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n address _dstAddress,\\n uint64 _nonce,\\n uint _gasLimit,\\n bytes calldata _payload\\n ) external;\\n\\n // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);\\n\\n // @notice get the outboundNonce from this source chain which, consequently, is always an EVM\\n // @param _srcAddress - the source chain contract address\\n function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);\\n\\n // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery\\n // @param _dstChainId - the destination chain identifier\\n // @param _userApplication - the user app address on this EVM chain\\n // @param _payload - the custom message to send over LayerZero\\n // @param _payInZRO - if false, user app pays the protocol fee in native token\\n // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain\\n function estimateFees(\\n uint16 _dstChainId,\\n address _userApplication,\\n bytes calldata _payload,\\n bool _payInZRO,\\n bytes calldata _adapterParam\\n ) external view returns (uint nativeFee, uint zroFee);\\n\\n // @notice get this Endpoint's immutable source identifier\\n function getChainId() external view returns (uint16);\\n\\n // @notice the interface to retry failed message on this Endpoint destination\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n // @param _payload - the payload to be retried\\n function retryPayload(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n bytes calldata _payload\\n ) external;\\n\\n // @notice query if any STORED payload (message blocking) at the endpoint.\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);\\n\\n // @notice query if the _libraryAddress is valid for sending msgs.\\n // @param _userApplication - the user app address on this EVM chain\\n function getSendLibraryAddress(address _userApplication) external view returns (address);\\n\\n // @notice query if the _libraryAddress is valid for receiving msgs.\\n // @param _userApplication - the user app address on this EVM chain\\n function getReceiveLibraryAddress(address _userApplication) external view returns (address);\\n\\n // @notice query if the non-reentrancy guard for send() is on\\n // @return true if the guard is on. false otherwise\\n function isSendingPayload() external view returns (bool);\\n\\n // @notice query if the non-reentrancy guard for receive() is on\\n // @return true if the guard is on. false otherwise\\n function isReceivingPayload() external view returns (bool);\\n\\n // @notice get the configuration of the LayerZero messaging library of the specified version\\n // @param _version - messaging library version\\n // @param _chainId - the chainId for the pending config change\\n // @param _userApplication - the contract address of the user application\\n // @param _configType - type of configuration. every messaging library has its own convention.\\n function getConfig(\\n uint16 _version,\\n uint16 _chainId,\\n address _userApplication,\\n uint _configType\\n ) external view returns (bytes memory);\\n\\n // @notice get the send() LayerZero messaging library version\\n // @param _userApplication - the contract address of the user application\\n function getSendVersion(address _userApplication) external view returns (uint16);\\n\\n // @notice get the lzReceive() LayerZero messaging library version\\n // @param _userApplication - the contract address of the user application\\n function getReceiveVersion(address _userApplication) external view returns (uint16);\\n}\\n\",\"keccak256\":\"0xab7fcacc672251c850f00c0abd4100df9afcc4ad70b8d331a2fd4cb07acab9f4\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroReceiver.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\ninterface ILayerZeroReceiver {\\n // @notice LayerZero endpoint will invoke this function to deliver the message on the destination\\n // @param _srcChainId - the source endpoint identifier\\n // @param _srcAddress - the source sending contract address from the source chain\\n // @param _nonce - the ordered message nonce\\n // @param _payload - the signed payload is the UA bytes has encoded to be sent\\n function lzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) external;\\n}\\n\",\"keccak256\":\"0xac1966c1229bd4dc36b6c69eeb94a537bd9aa2198d7623b9ba7f8f7dbe79bb4c\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroUserApplicationConfig.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\ninterface ILayerZeroUserApplicationConfig {\\n // @notice set the configuration of the LayerZero messaging library of the specified version\\n // @param _version - messaging library version\\n // @param _chainId - the chainId for the pending config change\\n // @param _configType - type of configuration. every messaging library has its own convention.\\n // @param _config - configuration in the bytes. can encode arbitrary content.\\n function setConfig(\\n uint16 _version,\\n uint16 _chainId,\\n uint _configType,\\n bytes calldata _config\\n ) external;\\n\\n // @notice set the send() LayerZero messaging library version to _version\\n // @param _version - new messaging library version\\n function setSendVersion(uint16 _version) external;\\n\\n // @notice set the lzReceive() LayerZero messaging library version to _version\\n // @param _version - new messaging library version\\n function setReceiveVersion(uint16 _version) external;\\n\\n // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload\\n // @param _srcChainId - the chainId of the source chain\\n // @param _srcAddress - the contract address of the source contract at the source chain\\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;\\n}\\n\",\"keccak256\":\"0xb4df93aeb0fb46373a4fb728ad2603edc8b9a1577eee8d801768dc115bf96498\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OFTCoreV2.sol\\\";\\nimport \\\"./interfaces/IOFTV2.sol\\\";\\nimport \\\"@openzeppelin/contracts/utils/introspection/ERC165.sol\\\";\\n\\nabstract contract BaseOFTV2 is OFTCoreV2, ERC165, IOFTV2 {\\n constructor(uint8 _sharedDecimals, address _lzEndpoint) OFTCoreV2(_sharedDecimals, _lzEndpoint) {}\\n\\n /************************************************************************\\n * public functions\\n ************************************************************************/\\n function sendFrom(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n LzCallParams calldata _callParams\\n ) public payable virtual override {\\n _send(_from, _dstChainId, _toAddress, _amount, _callParams.refundAddress, _callParams.zroPaymentAddress, _callParams.adapterParams);\\n }\\n\\n function sendAndCall(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes calldata _payload,\\n uint64 _dstGasForCall,\\n LzCallParams calldata _callParams\\n ) public payable virtual override {\\n _sendAndCall(\\n _from,\\n _dstChainId,\\n _toAddress,\\n _amount,\\n _payload,\\n _dstGasForCall,\\n _callParams.refundAddress,\\n _callParams.zroPaymentAddress,\\n _callParams.adapterParams\\n );\\n }\\n\\n /************************************************************************\\n * public view functions\\n ************************************************************************/\\n function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {\\n return interfaceId == type(IOFTV2).interfaceId || super.supportsInterface(interfaceId);\\n }\\n\\n function estimateSendFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bool _useZro,\\n bytes calldata _adapterParams\\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\\n return _estimateSendFee(_dstChainId, _toAddress, _amount, _useZro, _adapterParams);\\n }\\n\\n function estimateSendAndCallFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes calldata _payload,\\n uint64 _dstGasForCall,\\n bool _useZro,\\n bytes calldata _adapterParams\\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\\n return _estimateSendAndCallFee(_dstChainId, _toAddress, _amount, _payload, _dstGasForCall, _useZro, _adapterParams);\\n }\\n\\n function circulatingSupply() public view virtual override returns (uint);\\n\\n function token() public view virtual override returns (address);\\n}\\n\",\"keccak256\":\"0x59d2d32dd14a4f58232b126a7d69608a85f82137bd56d8ce0fc28ff646cba943\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/OFTCoreV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../../../lzApp/NonblockingLzApp.sol\\\";\\nimport \\\"../../../libraries/ExcessivelySafeCall.sol\\\";\\nimport \\\"./interfaces/ICommonOFT.sol\\\";\\nimport \\\"./interfaces/IOFTReceiverV2.sol\\\";\\n\\nabstract contract OFTCoreV2 is NonblockingLzApp {\\n using BytesLib for bytes;\\n using ExcessivelySafeCall for address;\\n\\n uint public constant NO_EXTRA_GAS = 0;\\n\\n // packet type\\n uint8 public constant PT_SEND = 0;\\n uint8 public constant PT_SEND_AND_CALL = 1;\\n\\n uint8 public immutable sharedDecimals;\\n\\n mapping(uint16 => mapping(bytes => mapping(uint64 => bool))) public creditedPackets;\\n\\n /**\\n * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)\\n * `_nonce` is the outbound nonce\\n */\\n event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes32 indexed _toAddress, uint _amount);\\n\\n /**\\n * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.\\n * `_nonce` is the inbound nonce.\\n */\\n event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);\\n\\n event CallOFTReceivedSuccess(uint16 indexed _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _hash);\\n\\n event NonContractAddress(address _address);\\n\\n // _sharedDecimals should be the minimum decimals on all chains\\n constructor(uint8 _sharedDecimals, address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {\\n sharedDecimals = _sharedDecimals;\\n }\\n\\n /************************************************************************\\n * public functions\\n ************************************************************************/\\n function callOnOFTReceived(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes32 _from,\\n address _to,\\n uint _amount,\\n bytes calldata _payload,\\n uint _gasForCall\\n ) public virtual {\\n require(_msgSender() == address(this), \\\"OFTCore: caller must be OFTCore\\\");\\n\\n // send\\n _amount = _transferFrom(address(this), _to, _amount);\\n emit ReceiveFromChain(_srcChainId, _to, _amount);\\n\\n // call\\n IOFTReceiverV2(_to).onOFTReceived{gas: _gasForCall}(_srcChainId, _srcAddress, _nonce, _from, _amount, _payload);\\n }\\n\\n /************************************************************************\\n * internal functions\\n ************************************************************************/\\n function _estimateSendFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bool _useZro,\\n bytes memory _adapterParams\\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\\n // mock the payload for sendFrom()\\n bytes memory payload = _encodeSendPayload(_toAddress, _ld2sd(_amount));\\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\\n }\\n\\n function _estimateSendAndCallFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes memory _payload,\\n uint64 _dstGasForCall,\\n bool _useZro,\\n bytes memory _adapterParams\\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\\n // mock the payload for sendAndCall()\\n bytes memory payload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(_amount), _payload, _dstGasForCall);\\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\\n }\\n\\n function _nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual override {\\n uint8 packetType = _payload.toUint8(0);\\n\\n if (packetType == PT_SEND) {\\n _sendAck(_srcChainId, _srcAddress, _nonce, _payload);\\n } else if (packetType == PT_SEND_AND_CALL) {\\n _sendAndCallAck(_srcChainId, _srcAddress, _nonce, _payload);\\n } else {\\n revert(\\\"OFTCore: unknown packet type\\\");\\n }\\n }\\n\\n function _send(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams\\n ) internal virtual returns (uint amount) {\\n _checkGasLimit(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);\\n\\n (amount, ) = _removeDust(_amount);\\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount); // amount returned should not have dust\\n require(amount > 0, \\\"OFTCore: amount too small\\\");\\n\\n bytes memory lzPayload = _encodeSendPayload(_toAddress, _ld2sd(amount));\\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\\n\\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\\n }\\n\\n function _sendAck(\\n uint16 _srcChainId,\\n bytes memory,\\n uint64,\\n bytes memory _payload\\n ) internal virtual {\\n (address to, uint64 amountSD) = _decodeSendPayload(_payload);\\n if (to == address(0)) {\\n to = address(0xdead);\\n }\\n\\n uint amount = _sd2ld(amountSD);\\n amount = _creditTo(_srcChainId, to, amount);\\n\\n emit ReceiveFromChain(_srcChainId, to, amount);\\n }\\n\\n function _sendAndCall(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes memory _payload,\\n uint64 _dstGasForCall,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams\\n ) internal virtual returns (uint amount) {\\n _checkGasLimit(_dstChainId, PT_SEND_AND_CALL, _adapterParams, _dstGasForCall);\\n\\n (amount, ) = _removeDust(_amount);\\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount);\\n require(amount > 0, \\\"OFTCore: amount too small\\\");\\n\\n // encode the msg.sender into the payload instead of _from\\n bytes memory lzPayload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(amount), _payload, _dstGasForCall);\\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\\n\\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\\n }\\n\\n function _sendAndCallAck(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual {\\n (bytes32 from, address to, uint64 amountSD, bytes memory payloadForCall, uint64 gasForCall) = _decodeSendAndCallPayload(_payload);\\n\\n bool credited = creditedPackets[_srcChainId][_srcAddress][_nonce];\\n uint amount = _sd2ld(amountSD);\\n\\n // credit to this contract first, and then transfer to receiver only if callOnOFTReceived() succeeds\\n if (!credited) {\\n amount = _creditTo(_srcChainId, address(this), amount);\\n creditedPackets[_srcChainId][_srcAddress][_nonce] = true;\\n }\\n\\n if (!_isContract(to)) {\\n emit NonContractAddress(to);\\n return;\\n }\\n\\n // workaround for stack too deep\\n uint16 srcChainId = _srcChainId;\\n bytes memory srcAddress = _srcAddress;\\n uint64 nonce = _nonce;\\n bytes memory payload = _payload;\\n bytes32 from_ = from;\\n address to_ = to;\\n uint amount_ = amount;\\n bytes memory payloadForCall_ = payloadForCall;\\n\\n // no gas limit for the call if retry\\n uint gas = credited ? gasleft() : gasForCall;\\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\\n gasleft(),\\n 150,\\n abi.encodeWithSelector(this.callOnOFTReceived.selector, srcChainId, srcAddress, nonce, from_, to_, amount_, payloadForCall_, gas)\\n );\\n\\n if (success) {\\n bytes32 hash = keccak256(payload);\\n emit CallOFTReceivedSuccess(srcChainId, srcAddress, nonce, hash);\\n } else {\\n // store the failed message into the nonblockingLzApp\\n _storeFailedMessage(srcChainId, srcAddress, nonce, payload, reason);\\n }\\n }\\n\\n function _isContract(address _account) internal view returns (bool) {\\n return _account.code.length > 0;\\n }\\n\\n function _ld2sd(uint _amount) internal view virtual returns (uint64) {\\n uint amountSD = _amount / _ld2sdRate();\\n require(amountSD <= type(uint64).max, \\\"OFTCore: amountSD overflow\\\");\\n return uint64(amountSD);\\n }\\n\\n function _sd2ld(uint64 _amountSD) internal view virtual returns (uint) {\\n return _amountSD * _ld2sdRate();\\n }\\n\\n function _removeDust(uint _amount) internal view virtual returns (uint amountAfter, uint dust) {\\n dust = _amount % _ld2sdRate();\\n amountAfter = _amount - dust;\\n }\\n\\n function _encodeSendPayload(bytes32 _toAddress, uint64 _amountSD) internal view virtual returns (bytes memory) {\\n return abi.encodePacked(PT_SEND, _toAddress, _amountSD);\\n }\\n\\n function _decodeSendPayload(bytes memory _payload) internal view virtual returns (address to, uint64 amountSD) {\\n require(_payload.toUint8(0) == PT_SEND && _payload.length == 41, \\\"OFTCore: invalid payload\\\");\\n\\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\\n amountSD = _payload.toUint64(33);\\n }\\n\\n function _encodeSendAndCallPayload(\\n address _from,\\n bytes32 _toAddress,\\n uint64 _amountSD,\\n bytes memory _payload,\\n uint64 _dstGasForCall\\n ) internal view virtual returns (bytes memory) {\\n return abi.encodePacked(PT_SEND_AND_CALL, _toAddress, _amountSD, _addressToBytes32(_from), _dstGasForCall, _payload);\\n }\\n\\n function _decodeSendAndCallPayload(bytes memory _payload)\\n internal\\n view\\n virtual\\n returns (\\n bytes32 from,\\n address to,\\n uint64 amountSD,\\n bytes memory payload,\\n uint64 dstGasForCall\\n )\\n {\\n require(_payload.toUint8(0) == PT_SEND_AND_CALL, \\\"OFTCore: invalid payload\\\");\\n\\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\\n amountSD = _payload.toUint64(33);\\n from = _payload.toBytes32(41);\\n dstGasForCall = _payload.toUint64(73);\\n payload = _payload.slice(81, _payload.length - 81);\\n }\\n\\n function _addressToBytes32(address _address) internal pure virtual returns (bytes32) {\\n return bytes32(uint(uint160(_address)));\\n }\\n\\n function _debitFrom(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _creditTo(\\n uint16 _srcChainId,\\n address _toAddress,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _transferFrom(\\n address _from,\\n address _to,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _ld2sdRate() internal view virtual returns (uint);\\n}\\n\",\"keccak256\":\"0x96cf7a10c5af4243822d25e77985a4a46d12264f839593ded5378cd6519a8df0\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/ICommonOFT.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"@openzeppelin/contracts/utils/introspection/IERC165.sol\\\";\\n\\n/**\\n * @dev Interface of the IOFT core standard\\n */\\ninterface ICommonOFT is IERC165 {\\n\\n struct LzCallParams {\\n address payable refundAddress;\\n address zroPaymentAddress;\\n bytes adapterParams;\\n }\\n\\n /**\\n * @dev estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`)\\n * _dstChainId - L0 defined chain id to send tokens too\\n * _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain\\n * _amount - amount of the tokens to transfer\\n * _useZro - indicates to use zro to pay L0 fees\\n * _adapterParam - flexible bytes array to indicate messaging adapter services in L0\\n */\\n function estimateSendFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\\n\\n function estimateSendAndCallFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\\n\\n /**\\n * @dev returns the circulating amount of tokens on current chain\\n */\\n function circulatingSupply() external view returns (uint);\\n\\n /**\\n * @dev returns the address of the ERC20 token\\n */\\n function token() external view returns (address);\\n}\\n\",\"keccak256\":\"0x1d034ba786436c1fce8057352c87373098bd1d8026b24c8fbc7be28636d0c15d\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTReceiverV2.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\n\\npragma solidity >=0.5.0;\\n\\ninterface IOFTReceiverV2 {\\n /**\\n * @dev Called by the OFT contract when tokens are received from source chain.\\n * @param _srcChainId The chain id of the source chain.\\n * @param _srcAddress The address of the OFT token contract on the source chain.\\n * @param _nonce The nonce of the transaction on the source chain.\\n * @param _from The address of the account who calls the sendAndCall() on the source chain.\\n * @param _amount The amount of tokens to transfer.\\n * @param _payload Additional data with no specified format.\\n */\\n function onOFTReceived(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes32 _from, uint _amount, bytes calldata _payload) external;\\n}\\n\",\"keccak256\":\"0xf57e437ced3bc10bb333123bb49475dab47c7615b86401c4d872c29ad4928fd5\",\"license\":\"BUSL-1.1\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"./ICommonOFT.sol\\\";\\n\\n/**\\n * @dev Interface of the IOFT core standard\\n */\\ninterface IOFTV2 is ICommonOFT {\\n\\n /**\\n * @dev send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from`\\n * `_from` the owner of token\\n * `_dstChainId` the destination chain identifier\\n * `_toAddress` can be any size depending on the `dstChainId`.\\n * `_amount` the quantity of tokens in wei\\n * `_refundAddress` the address LayerZero refunds if too much message fee is sent\\n * `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token)\\n * `_adapterParams` is a flexible bytes array to indicate messaging adapter services\\n */\\n function sendFrom(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, LzCallParams calldata _callParams) external payable;\\n\\n function sendAndCall(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, LzCallParams calldata _callParams) external payable;\\n}\\n\",\"keccak256\":\"0xb1d31f341715347d49db4e2c0de27c49bbd70b5b3d9b0adb1050b2b3a305ab87\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n _requireNotPaused();\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n _requirePaused();\\n _;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Throws if the contract is paused.\\n */\\n function _requireNotPaused() internal view virtual {\\n require(!paused(), \\\"Pausable: paused\\\");\\n }\\n\\n /**\\n * @dev Throws if the contract is not paused.\\n */\\n function _requirePaused() internal view virtual {\\n require(paused(), \\\"Pausable: not paused\\\");\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0x0849d93b16c9940beb286a7864ed02724b248b93e0d80ef6355af5ef15c64773\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xec63854014a5b4f2b3290ab9103a21bdf902a508d0f41a8573fea49e98bf571a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/ERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./IERC165.sol\\\";\\n\\n/**\\n * @dev Implementation of the {IERC165} interface.\\n *\\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\\n * for the additional interface id that will be supported. For example:\\n *\\n * ```solidity\\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\\n * }\\n * ```\\n *\\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\\n */\\nabstract contract ERC165 is IERC165 {\\n /**\\n * @dev See {IERC165-supportsInterface}.\\n */\\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\\n return interfaceId == type(IERC165).interfaceId;\\n }\\n}\\n\",\"keccak256\":\"0xd10975de010d89fd1c78dc5e8a9a7e7f496198085c151648f20cba166b32582b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\\n *\\n * Implementers can declare support of contract interfaces, which can then be\\n * queried by others ({ERC165Checker}).\\n *\\n * For an implementation, see {ERC165}.\\n */\\ninterface IERC165 {\\n /**\\n * @dev Returns true if this contract implements the interface defined by\\n * `interfaceId`. See the corresponding\\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\\n * to learn more about how these ids are created.\\n *\\n * This function call must use less than 30 000 gas.\\n */\\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x447a5f3ddc18419d41ff92b3773fb86471b1db25773e07f877f548918a185bf1\",\"license\":\"MIT\"},\"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\ninterface OracleInterface {\\n function getPrice(address asset) external view returns (uint256);\\n}\\n\\ninterface ResilientOracleInterface is OracleInterface {\\n function updatePrice(address vToken) external;\\n\\n function updateAssetPrice(address asset) external;\\n\\n function getUnderlyingPrice(address vToken) external view returns (uint256);\\n}\\n\\ninterface TwapInterface is OracleInterface {\\n function updateTwap(address asset) external returns (uint256);\\n}\\n\\ninterface BoundValidatorInterface {\\n function validatePriceWithAnchorPrice(\\n address asset,\\n uint256 reporterPrice,\\n uint256 anchorPrice\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x40031b19684ca0c912e794d08c2c0b0d8be77d3c1bdc937830a0658eff899650\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \\\"./constants.sol\\\";\\n\\n/**\\n * @title Exponential module for storing fixed-precision decimals\\n * @author Compound\\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\\n * `Exp({mantissa: 5100000000000000000})`.\\n */\\ncontract ExponentialNoError {\\n struct Exp {\\n uint256 mantissa;\\n }\\n\\n struct Double {\\n uint256 mantissa;\\n }\\n\\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\\n uint256 internal constant DOUBLE_SCALE = 1e36;\\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\\n\\n /**\\n * @dev Truncates the given exp to a whole number value.\\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\\n */\\n function truncate(Exp memory exp) internal pure returns (uint256) {\\n // Note: We are not using careful math here as we're performing a division that cannot fail\\n return exp.mantissa / EXP_SCALE;\\n }\\n\\n /**\\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\\n Exp memory product = mul_(a, scalar);\\n return truncate(product);\\n }\\n\\n /**\\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\\n Exp memory product = mul_(a, scalar);\\n return add_(truncate(product), addend);\\n }\\n\\n /**\\n * @dev Checks if first Exp is less than second Exp.\\n */\\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\\n return left.mantissa < right.mantissa;\\n }\\n\\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\\n require(n <= type(uint224).max, errorMessage);\\n return uint224(n);\\n }\\n\\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\\n require(n <= type(uint32).max, errorMessage);\\n return uint32(n);\\n }\\n\\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\\n }\\n\\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\\n }\\n\\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\\n }\\n\\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\\n }\\n\\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\\n }\\n\\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: mul_(a.mantissa, b) });\\n }\\n\\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\\n return mul_(a, b.mantissa) / EXP_SCALE;\\n }\\n\\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\\n }\\n\\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: mul_(a.mantissa, b) });\\n }\\n\\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\\n }\\n\\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\\n }\\n\\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: div_(a.mantissa, b) });\\n }\\n\\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\\n return div_(mul_(a, EXP_SCALE), b.mantissa);\\n }\\n\\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\\n }\\n\\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(a.mantissa, b) });\\n }\\n\\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\\n }\\n\\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\\n }\\n}\\n\",\"keccak256\":\"0x6cf5430c2db151ab24ef0f567ed443c0b75b8b6051a62cacbe83f28b16834605\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/constants.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\\nuint256 constant EXP_SCALE = 1e18;\\n\\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\\nuint256 constant MANTISSA_ONE = EXP_SCALE;\\n\",\"keccak256\":\"0x44de02d7837ee1d4dcf6e9f5e783e9d9e0bec0154f23f5661fb54810cff9f892\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/BaseXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { ResilientOracleInterface } from \\\"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\\\";\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { BaseOFTV2 } from \\\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { ExponentialNoError } from \\\"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\\\";\\n\\n/**\\n * @title BaseXVSProxyOFT\\n * @author Venus\\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\\n * It manages transaction limits of a single and daily transactions.\\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\\n */\\n\\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\\n using SafeERC20 for IERC20;\\n IERC20 internal immutable innerToken;\\n uint256 internal immutable ld2sdRate;\\n bool public sendAndCallEnabled;\\n\\n /**\\n * @notice The address of ResilientOracle contract wrapped in its interface.\\n */\\n ResilientOracleInterface public oracle;\\n /**\\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\\n /**\\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\\n /**\\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\\n /**\\n * @notice Timestamp when the last 24-hour window started from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\\n /**\\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\\n /**\\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\\n /**\\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\\n /**\\n * @notice Timestamp when the last 24-hour window started from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\\n /**\\n * @notice Address on which cap check and bound limit is not applicable.\\n */\\n mapping(address => bool) public whitelist;\\n\\n /**\\n * @notice Emitted when address is added to whitelist.\\n */\\n event SetWhitelist(address indexed addr, bool isWhitelist);\\n /**\\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\\n */\\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\\n */\\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\\n */\\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\\n */\\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Event emitted when oracle is modified.\\n */\\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\\n /**\\n * @notice Event emitted when trusted remote sets to empty.\\n */\\n event TrustedRemoteRemoved(uint16 chainId);\\n /**\\n * @notice Event emitted when inner token set successfully.\\n */\\n event InnerTokenAdded(address indexed innerToken);\\n /**\\n *@notice Emitted on sweep token success\\n */\\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\\n /**\\n * @notice Event emitted when SendAndCallEnabled updated successfully.\\n */\\n event UpdateSendAndCallEnabled(bool indexed enabled);\\n /**\\n *@notice Error thrown when this contract balance is less than sweep amount\\n */\\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\\n\\n /**\\n * @param tokenAddress_ Address of the inner token.\\n * @param sharedDecimals_ Number of shared decimals.\\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\\n * @param oracle_ Address of the price oracle.\\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\\n * @custom:event Emits InnerTokenAdded with token address.\\n * @custom:event Emits OracleChanged with zero address and oracle address.\\n */\\n constructor(\\n address tokenAddress_,\\n uint8 sharedDecimals_,\\n address lzEndpoint_,\\n address oracle_\\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\\n ensureNonzeroAddress(tokenAddress_);\\n ensureNonzeroAddress(lzEndpoint_);\\n ensureNonzeroAddress(oracle_);\\n\\n innerToken = IERC20(tokenAddress_);\\n\\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\\\"decimals()\\\"));\\n require(success, \\\"ProxyOFT: failed to get token decimals\\\");\\n uint8 decimals = abi.decode(data, (uint8));\\n\\n require(sharedDecimals_ <= decimals, \\\"ProxyOFT: sharedDecimals must be <= decimals\\\");\\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\\n\\n emit InnerTokenAdded(tokenAddress_);\\n emit OracleChanged(address(0), oracle_);\\n\\n oracle = ResilientOracleInterface(oracle_);\\n }\\n\\n /**\\n * @notice Set the address of the ResilientOracle contract.\\n * @dev Reverts if the new address is zero.\\n * @param oracleAddress_ The new address of the ResilientOracle contract.\\n * @custom:access Only owner.\\n * @custom:event Emits OracleChanged with old and new oracle address.\\n */\\n function setOracle(address oracleAddress_) external onlyOwner {\\n ensureNonzeroAddress(oracleAddress_);\\n emit OracleChanged(address(oracle), oracleAddress_);\\n oracle = ResilientOracleInterface(oracleAddress_);\\n }\\n\\n /**\\n * @notice Sets the limit of single transaction amount.\\n * @param chainId_ Destination chain id.\\n * @param limit_ Amount in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\\n */\\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \\\"Single transaction limit > Daily limit\\\");\\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the limit of daily (24 Hour) transactions amount.\\n * @param chainId_ Destination chain id.\\n * @param limit_ Amount in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\\n */\\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \\\"Daily limit < single transaction limit\\\");\\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\\n chainIdToMaxDailyLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the maximum limit for a single receive transaction.\\n * @param chainId_ The destination chain ID.\\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\\n */\\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \\\"single receive transaction limit > Daily limit\\\");\\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the maximum daily limit for receiving transactions.\\n * @param chainId_ The destination chain ID.\\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\\n */\\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(\\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\\n \\\"Daily limit < single receive transaction limit\\\"\\n );\\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the whitelist address to skip checks on transaction limit.\\n * @param user_ Address to be add in whitelist.\\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\\n * @custom:access Only owner.\\n * @custom:event Emits setWhitelist.\\n */\\n function setWhitelist(address user_, bool val_) external onlyOwner {\\n emit SetWhitelist(user_, val_);\\n whitelist[user_] = val_;\\n }\\n\\n /**\\n * @notice Triggers stopped state of the bridge.\\n * @custom:access Only owner.\\n */\\n function pause() external onlyOwner {\\n _pause();\\n }\\n\\n /**\\n * @notice Triggers resume state of the bridge.\\n * @custom:access Only owner.\\n */\\n function unpause() external onlyOwner {\\n _unpause();\\n }\\n\\n /**\\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\\n * @param token_ The address of the ERC-20 token to sweep\\n * @param to_ The address of the recipient\\n * @param amount_ The amount of tokens needs to transfer\\n * @custom:event Emits SweepToken event\\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\\n * @custom:access Only Owner\\n */\\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\\n uint256 balance = token_.balanceOf(address(this));\\n if (amount_ > balance) {\\n revert InsufficientBalance(amount_, balance);\\n }\\n\\n emit SweepToken(address(token_), to_, amount_);\\n\\n token_.safeTransfer(to_, amount_);\\n }\\n\\n /**\\n * @notice Remove trusted remote from storage.\\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\\n * @custom:access Only owner.\\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\\n */\\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\\n delete trustedRemoteLookup[remoteChainId_];\\n emit TrustedRemoteRemoved(remoteChainId_);\\n }\\n\\n /**\\n * @notice It enables or disables sendAndCall functionality for the bridge.\\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\\n */\\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\\n sendAndCallEnabled = enabled_;\\n emit UpdateSendAndCallEnabled(enabled_);\\n }\\n\\n /**\\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\\n * @param from_ The sender's address initiating the transfer.\\n * @param dstChainId_ Indicates destination chain.\\n * @param amount_ The quantity of tokens to be transferred.\\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\\n * @return maxDailyLimit The maximum daily limit for transactions.\\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\\n */\\n function isEligibleToSend(\\n address from_,\\n uint16 dstChainId_,\\n uint256 amount_\\n )\\n external\\n view\\n returns (\\n bool eligibleToSend,\\n uint256 maxSingleTransactionLimit,\\n uint256 maxDailyLimit,\\n uint256 amountInUsd,\\n uint256 transferredInWindow,\\n uint256 last24HourWindowStart,\\n bool isWhiteListedUser\\n )\\n {\\n // Check if the sender's address is whitelisted\\n isWhiteListedUser = whitelist[from_];\\n\\n // Calculate the amount in USD using the oracle price\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\\n\\n // Load values for the 24-hour window checks\\n uint256 currentBlockTimestamp = block.timestamp;\\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\\n transferredInWindow = amountInUsd;\\n last24HourWindowStart = currentBlockTimestamp;\\n } else {\\n transferredInWindow += amountInUsd;\\n }\\n eligibleToSend = (isWhiteListedUser ||\\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\\n }\\n\\n /**\\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\\n * @param from_ Address from which tokens will be debited.\\n * @param dstChainId_ Destination chain id on which tokens will be send.\\n * @param toAddress_ Address on which tokens will be credited on destination chain.\\n * @param amount_ Amount of tokens that will be transferred.\\n * @param payload_ Additional data payload for the call on the destination chain.\\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\\n * and adapter params.\\n */\\n function sendAndCall(\\n address from_,\\n uint16 dstChainId_,\\n bytes32 toAddress_,\\n uint256 amount_,\\n bytes calldata payload_,\\n uint64 dstGasForCall_,\\n LzCallParams calldata callparams_\\n ) public payable override {\\n require(sendAndCallEnabled, \\\"sendAndCall is disabled\\\");\\n\\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\\n }\\n\\n function retryMessage(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public payable override {\\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\\n require(\\n _srcAddress.length == trustedRemote.length &&\\n trustedRemote.length > 0 &&\\n keccak256(_srcAddress) == keccak256(trustedRemote),\\n \\\"LzApp: invalid source sending contract\\\"\\n );\\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @notice Return's the address of the inner token of this bridge.\\n * @return Address of the inner token of this bridge.\\n */\\n function token() public view override returns (address) {\\n return address(innerToken);\\n }\\n\\n /**\\n * @notice Checks if the sender is eligible to send tokens\\n * @param from_ Sender's address sending tokens\\n * @param dstChainId_ Chain id on which tokens should be sent\\n * @param amount_ Amount of tokens to be sent\\n */\\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\\n // Check if the sender's address is whitelisted\\n bool isWhiteListedUser = whitelist[from_];\\n // Check if the user is whitelisted and return if true\\n if (isWhiteListedUser) {\\n return;\\n }\\n\\n // Calculate the amount in USD using the oracle price\\n uint256 amountInUsd;\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\\n\\n // Load values for the 24-hour window checks\\n uint256 currentBlockTimestamp = block.timestamp;\\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\\n\\n // Revert if the amount exceeds the single transaction limit\\n require(amountInUsd <= maxSingleTransactionLimit, \\\"Single Transaction Limit Exceed\\\");\\n\\n // Check if the time window has changed (more than 24 hours have passed)\\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\\n transferredInWindow = amountInUsd;\\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\\n } else {\\n transferredInWindow += amountInUsd;\\n }\\n\\n // Revert if the amount exceeds the daily limit\\n require(transferredInWindow <= maxDailyLimit, \\\"Daily Transaction Limit Exceed\\\");\\n\\n // Update the amount for the 24-hour window\\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\\n }\\n\\n /**\\n * @notice Checks if receiver is able to receive tokens\\n * @param toAddress_ Receiver address\\n * @param srcChainId_ Source chain id from which token is send\\n * @param receivedAmount_ Amount of tokens received\\n */\\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\\n // Check if the recipient's address is whitelisted\\n bool isWhiteListedUser = whitelist[toAddress_];\\n // Check if the user is whitelisted and return if true\\n if (isWhiteListedUser) {\\n return;\\n }\\n\\n // Calculate the received amount in USD using the oracle price\\n uint256 receivedAmountInUsd;\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\\n\\n uint256 currentBlockTimestamp = block.timestamp;\\n\\n // Load values for the 24-hour window checks for receiving\\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\\n\\n // Check if the received amount exceeds the single transaction limit\\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \\\"Single Transaction Limit Exceed\\\");\\n\\n // Check if the time window has changed (more than 24 hours have passed)\\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\\n receivedInWindow = receivedAmountInUsd;\\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\\n } else {\\n receivedInWindow += receivedAmountInUsd;\\n }\\n\\n // Revert if the received amount exceeds the daily limit\\n require(receivedInWindow <= maxDailyReceiveLimit, \\\"Daily Transaction Limit Exceed\\\");\\n\\n // Update the received amount for the 24-hour window\\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\\n }\\n\\n /**\\n * @notice Transfer tokens from sender to receiver account.\\n * @param from_ Address from which token has to be transferred(Sender).\\n * @param to_ Address on which token will be tranferred(Receiver).\\n * @param amount_ Amount of token to be transferred.\\n * @return Actual balance difference.\\n */\\n function _transferFrom(\\n address from_,\\n address to_,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n uint256 before = innerToken.balanceOf(to_);\\n if (from_ == address(this)) {\\n innerToken.safeTransfer(to_, amount_);\\n } else {\\n innerToken.safeTransferFrom(from_, to_, amount_);\\n }\\n return innerToken.balanceOf(to_) - before;\\n }\\n\\n /**\\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\\n * @return Conversion rate factor.\\n */\\n function _ld2sdRate() internal view override returns (uint256) {\\n return ld2sdRate;\\n }\\n}\\n\",\"keccak256\":\"0x75d98574e674d1c3f35ac92c9e930d0238059b540d3385abeb14b20ef03cb13c\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSProxyOFTDest.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { IXVS } from \\\"./interfaces/IXVS.sol\\\";\\nimport { BaseXVSProxyOFT } from \\\"./BaseXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSProxyOFTDest\\n * @author Venus\\n * @notice XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT,\\n * and focuses on managing token transfers to the destination chain.\\n * It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\\n */\\n\\ncontract XVSProxyOFTDest is BaseXVSProxyOFT {\\n /**\\n * @notice Emits when stored message dropped without successful retrying.\\n */\\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\\n\\n constructor(\\n address tokenAddress_,\\n uint8 sharedDecimals_,\\n address lzEndpoint_,\\n address oracle_\\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\\n\\n /**\\n * @notice Clear failed messages from the storage.\\n * @param srcChainId_ Chain id of source\\n * @param srcAddress_ Address of source followed by current bridge address\\n * @param nonce_ Nonce_ of the transaction\\n * @custom:access Only owner\\n * @custom:event Emits DropFailedMessage on clearance of failed message.\\n */\\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\\n }\\n\\n /**\\n * @notice Returns the total circulating supply of the token on the destination chain i.e (total supply).\\n * @return total circulating supply of the token on the destination chain.\\n */\\n function circulatingSupply() public view override returns (uint256) {\\n return innerToken.totalSupply();\\n }\\n\\n /**\\n * @notice Debit tokens from the given address\\n * @param from_ Address from which tokens to be debited\\n * @param dstChainId_ Destination chain id\\n * @param amount_ Amount of tokens to be debited\\n * @return Actual amount debited\\n */\\n function _debitFrom(\\n address from_,\\n uint16 dstChainId_,\\n bytes32,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n require(from_ == _msgSender(), \\\"ProxyOFT: owner is not send caller\\\");\\n _isEligibleToSend(from_, dstChainId_, amount_);\\n IXVS(address(innerToken)).burn(from_, amount_);\\n return amount_;\\n }\\n\\n /**\\n * @notice Credit tokens in the given account\\n * @param srcChainId_ Source chain id\\n * @param toAddress_ Address on which token will be credited\\n * @param amount_ Amount of tokens to be credited\\n * @return Actual amount credited\\n */\\n function _creditTo(\\n uint16 srcChainId_,\\n address toAddress_,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\\n IXVS(address(innerToken)).mint(toAddress_, amount_);\\n return amount_;\\n }\\n}\\n\",\"keccak256\":\"0x4a4bf23d37f26b82877c24326d81699f0ca217a593599fa179d45db8be919e50\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVS.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/**\\n * @title IXVS\\n * @author Venus\\n * @notice Interface implemented by `XVS` token.\\n */\\ninterface IXVS {\\n function mint(address to, uint256 amount) external;\\n\\n function burn(address from, uint256 amount) external;\\n}\\n\",\"keccak256\":\"0x55c954155c4499e8ef1915ad28c5567c247e4397dc12ba553b33c5edb1114dba\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x6101006040523480156200001257600080fd5b5060405162005adf38038062005adf833981016040819052620000359162000379565b6000805460ff19169055838383838282818180806200005433620002c6565b6001600160a01b0316608052505060ff1660a05250620000769050846200031f565b62000081826200031f565b6200008c816200031f565b6001600160a01b03841660c081905260408051600481526024810182526020810180516001600160e01b031663313ce56760e01b179052905160009283929091620000d89190620003d6565b600060405180830381855afa9150503d806000811462000115576040519150601f19603f3d011682016040523d82523d6000602084013e6200011a565b606091505b509150915081620001815760405162461bcd60e51b815260206004820152602660248201527f50726f78794f46543a206661696c656420746f2067657420746f6b656e20646560448201526563696d616c7360d01b60648201526084015b60405180910390fd5b60008180602001905181019062000199919062000414565b90508060ff168660ff161115620002085760405162461bcd60e51b815260206004820152602c60248201527f50726f78794f46543a20736861726564446563696d616c73206d75737420626560448201526b203c3d20646563696d616c7360a01b606482015260840162000178565b6200021486826200044f565b6200022190600a62000574565b60e0526040516001600160a01b038816907f0b673f021ff9a27bbe58f282908695869e130b3103029190387b83650806c2c390600090a26040516001600160a01b038516906000907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd908290a35050600780546001600160a01b0390931661010002610100600160a81b03199093169290921790915550620005859650505050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6001600160a01b03811662000347576040516342bcdf7f60e11b815260040160405180910390fd5b50565b80516001600160a01b03811681146200036257600080fd5b919050565b805160ff811681146200036257600080fd5b600080600080608085870312156200039057600080fd5b6200039b856200034a565b9350620003ab6020860162000367565b9250620003bb604086016200034a565b9150620003cb606086016200034a565b905092959194509250565b6000825160005b81811015620003f95760208186018101518583015201620003dd565b8181111562000409576000828501525b509190910192915050565b6000602082840312156200042757600080fd5b620004328262000367565b9392505050565b634e487b7160e01b600052601160045260246000fd5b600060ff821660ff8416808210156200046c576200046c62000439565b90039392505050565b600181815b80851115620004b65781600019048211156200049a576200049a62000439565b80851615620004a857918102915b93841c93908002906200047a565b509250929050565b600082620004cf575060016200056e565b81620004de575060006200056e565b8160018114620004f75760028114620005025762000522565b60019150506200056e565b60ff84111562000516576200051662000439565b50506001821b6200056e565b5060208310610133831016604e8410600b841016171562000547575081810a6200056e565b62000553838362000475565b80600019048211156200056a576200056a62000439565b0290505b92915050565b60006200043260ff841683620004be565b60805160a05160c05160e05161548d62000652600039600081816130d4015281816136470152613b82015260008181610ca10152818161106801528181611ba701528181612d7501528181612e0101528181612e3a01528181612e830152818161371d01528181613beb01528181613db401526141e4015260006108be015260008181610abe01528181610cf501528181610f3c01528181610fe40152818161142601528181611ed9015281816123cc015281816125a701528181612aa501526138ab015261548d6000f3fe6080604052600436106103b75760003560e01c80637dc0d1d0116101f2578063baf3292d1161010d578063df2a5b3b116100a0578063f2fde38b1161006f578063f2fde38b14610c52578063f5ecbdbc14610c72578063fc0c546a14610c92578063fdff235b14610cc557600080fd5b8063df2a5b3b14610bdd578063e6a20ae614610bfd578063eaffd49a14610c12578063eb8d72b714610c3257600080fd5b8063cc01e9b6116100dc578063cc01e9b614610b50578063cc7015ae14610b70578063d1deba1f14610b9d578063d708a46814610bb057600080fd5b8063baf3292d14610ae0578063c1e9132e14610b00578063c446183414610b1a578063cbed8b9c14610b3057600080fd5b806393a61d6c116101855780639f38369a116101545780639f38369a14610a4c578063a4c51df514610a6c578063a6c3d16514610a8c578063b353aaa714610aac57600080fd5b806393a61d6c1461097d578063950c8a74146109aa5780639b19251a146109ca5780639bdb9812146109fa57600080fd5b80638cfd8f5c116101c15780638cfd8f5c146108e05780638da5cb5b14610918578063904365671461093b5780639358928b1461096857600080fd5b80637dc0d1d01461083a5780638456cb591461087757806384e69c691461088c578063857749b0146108ac57600080fd5b80634c42899a116102e257806364aff9ec11610275578063715018a611610244578063715018a6146107ce5780637533d788146107da57806376203b48146108075780637adbf9731461081a57600080fd5b806364aff9ec1461075b57806366ad5c8a1461077b578063695ef6bf1461079b57806369c1e7b8146107ae57600080fd5b806353489d6c116102b157806353489d6c146106b457806353d6fd59146106d45780635b8c41e6146106f45780635c975abb1461074357600080fd5b80634c42899a146106135780634cec62561461063a5780634ed2c662146106675780634f4ba0f41461068757600080fd5b80632dbbec081161035a5780633f1f4fa4116103295780633f1f4fa41461059c5780633f4ba83a146105c957806342d65a8d146105de57806344770515146105fe57600080fd5b80632dbbec08146104ec578063365260b41461050c5780633c4ec39b146105415780633d8b38f61461057c57600080fd5b80630df37483116103965780630df374831461043357806310ddb13714610453578063182b4b89146104735780632488eec8146104cc57600080fd5b80621d3567146103bc57806301ffc9a7146103de57806307e0db1714610413575b600080fd5b3480156103c857600080fd5b506103dc6103d736600461466d565b610cf2565b005b3480156103ea57600080fd5b506103fe6103f9366004614700565b610ee4565b60405190151581526020015b60405180910390f35b34801561041f57600080fd5b506103dc61042e36600461472a565b610f1b565b34801561043f57600080fd5b506103dc61044e366004614745565b610fa4565b34801561045f57600080fd5b506103dc61046e36600461472a565b610fc3565b34801561047f57600080fd5b5061049361048e366004614784565b61101b565b6040805197151588526020880196909652948601939093526060850191909152608084015260a0830152151560c082015260e00161040a565b3480156104d857600080fd5b506103dc6104e7366004614745565b611191565b3480156104f857600080fd5b506103dc61050736600461472a565b611275565b34801561051857600080fd5b5061052c6105273660046147d0565b6112d4565b6040805192835260208301919091520161040a565b34801561054d57600080fd5b5061056e61055c36600461472a565b600d6020526000908152604090205481565b60405190815260200161040a565b34801561058857600080fd5b506103fe610597366004614837565b611329565b3480156105a857600080fd5b5061056e6105b736600461472a565b60036020526000908152604090205481565b3480156105d557600080fd5b506103dc6113f5565b3480156105ea57600080fd5b506103dc6105f9366004614837565b611407565b34801561060a57600080fd5b5061056e600081565b34801561061f57600080fd5b50610628600081565b60405160ff909116815260200161040a565b34801561064657600080fd5b5061056e61065536600461472a565b600a6020526000908152604090205481565b34801561067357600080fd5b506103dc610682366004614889565b61148d565b34801561069357600080fd5b5061056e6106a236600461472a565b60096020526000908152604090205481565b3480156106c057600080fd5b506103dc6106cf366004614745565b6114d2565b3480156106e057600080fd5b506103dc6106ef3660046148a6565b6115b6565b34801561070057600080fd5b5061056e61070f36600461494c565b6005602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205481565b34801561074f57600080fd5b5060005460ff166103fe565b34801561076757600080fd5b506103dc6107763660046149ec565b61162e565b34801561078757600080fd5b506103dc61079636600461466d565b611735565b6103dc6107a9366004614a45565b611811565b3480156107ba57600080fd5b506103dc6107c9366004614745565b61187c565b3480156103dc57600080fd5b3480156107e657600080fd5b506107fa6107f536600461472a565b611968565b60405161040a9190614b10565b6103dc610815366004614b23565b611a02565b34801561082657600080fd5b506103dc610835366004614bd5565b611a6e565b34801561084657600080fd5b5060075461085f9061010090046001600160a01b031681565b6040516001600160a01b03909116815260200161040a565b34801561088357600080fd5b506103dc611ae6565b34801561089857600080fd5b506103dc6108a736600461494c565b611af6565b3480156108b857600080fd5b506106287f000000000000000000000000000000000000000000000000000000000000000081565b3480156108ec57600080fd5b5061056e6108fb366004614bf2565b600260209081526000928352604080842090915290825290205481565b34801561092457600080fd5b5060005461010090046001600160a01b031661085f565b34801561094757600080fd5b5061056e61095636600461472a565b600c6020526000908152604090205481565b34801561097457600080fd5b5061056e611ba3565b34801561098957600080fd5b5061056e61099836600461472a565b600b6020526000908152604090205481565b3480156109b657600080fd5b5060045461085f906001600160a01b031681565b3480156109d657600080fd5b506103fe6109e5366004614bd5565b60106020526000908152604090205460ff1681565b348015610a0657600080fd5b506103fe610a1536600461494c565b6006602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205460ff1681565b348015610a5857600080fd5b506107fa610a6736600461472a565b611c2c565b348015610a7857600080fd5b5061052c610a87366004614c25565b611d42565b348015610a9857600080fd5b506103dc610aa7366004614837565b611dd1565b348015610ab857600080fd5b5061085f7f000000000000000000000000000000000000000000000000000000000000000081565b348015610aec57600080fd5b506103dc610afb366004614bd5565b611e64565b348015610b0c57600080fd5b506007546103fe9060ff1681565b348015610b2657600080fd5b5061056e61271081565b348015610b3c57600080fd5b506103dc610b4b366004614ce2565b611eba565b348015610b5c57600080fd5b506103dc610b6b366004614745565b611f4f565b348015610b7c57600080fd5b5061056e610b8b36600461472a565b60086020526000908152604090205481565b6103dc610bab36600461466d565b61203b565b348015610bbc57600080fd5b5061056e610bcb36600461472a565b600e6020526000908152604090205481565b348015610be957600080fd5b506103dc610bf8366004614d50565b61213f565b348015610c0957600080fd5b50610628600181565b348015610c1e57600080fd5b506103dc610c2d366004614d6e565b6121a9565b348015610c3e57600080fd5b506103dc610c4d366004614837565b6122c8565b348015610c5e57600080fd5b506103dc610c6d366004614bd5565b612322565b348015610c7e57600080fd5b506107fa610c8d366004614e36565b61239b565b348015610c9e57600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061085f565b348015610cd157600080fd5b5061056e610ce036600461472a565b600f6020526000908152604090205481565b337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031614610d6f5760405162461bcd60e51b815260206004820152601e60248201527f4c7a4170703a20696e76616c696420656e64706f696e742063616c6c6572000060448201526064015b60405180910390fd5b61ffff861660009081526001602052604081208054610d8d90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054610db990614e83565b8015610e065780601f10610ddb57610100808354040283529160200191610e06565b820191906000526020600020905b815481529060010190602001808311610de957829003601f168201915b50505050509050805186869050148015610e21575060008151115b8015610e49575080516020820120604051610e3f9088908890614eb7565b6040518091039020145b610e655760405162461bcd60e51b8152600401610d6690614ec7565b610edb8787878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8a018190048102820181019092528881528a93509150889088908190840183828082843760009201919091525061244e92505050565b50505050505050565b60006001600160e01b03198216631f7ecdf760e01b1480610f1557506301ffc9a760e01b6001600160e01b03198316145b92915050565b610f236124c7565b6040516307e0db1760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906307e0db17906024015b600060405180830381600087803b158015610f8957600080fd5b505af1158015610f9d573d6000803e3d6000fd5b5050505050565b610fac6124c7565b61ffff909116600090815260036020526040902055565b610fcb6124c7565b6040516310ddb13760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906310ddb13790602401610f6f565b6001600160a01b03838116600090815260106020908152604080832054815192830190915260075492938493849384938493849360ff909216928492909182916101009004166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156110cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110ef9190614f0d565b905290506110fd818a612527565b61ffff8b166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054919a509098509196509094509250426201518061114b8583614f3c565b111561115c57859450809350611169565b6111668686614f53565b94505b828061118057508786111580156111805750868511155b985050509397509397509397909450565b6111996124c7565b61ffff821660009081526008602052604090205481101561120b5760405162461bcd60e51b815260206004820152602660248201527f4461696c79206c696d6974203c2073696e676c65207472616e73616374696f6e604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600960209081526040918290205482519384529083015281018290527f4dd31065e259d5284e44d1f9265710da72eafcf78dc925e3881189fc3b71f6939060600160405180910390a161ffff909116600090815260096020526040902055565b61127d6124c7565b61ffff81166000908152600160205260408120611299916144b0565b60405161ffff821681527f6d5075c81d4d9e75bec6052f4e44f58f8a8cf1327544addbbf015fb06f83bd37906020015b60405180910390a150565b60008061131a8888888888888080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061253f92505050565b91509150965096945050505050565b61ffff83166000908152600160205260408120805482919061134a90614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461137690614e83565b80156113c35780601f10611398576101008083540402835291602001916113c3565b820191906000526020600020905b8154815290600101906020018083116113a657829003601f168201915b5050505050905083836040516113da929190614eb7565b60405180910390208180519060200120149150509392505050565b6113fd6124c7565b611405612633565b565b61140f6124c7565b6040516342d65a8d60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906342d65a8d9061145f90869086908690600401614f94565b600060405180830381600087803b15801561147957600080fd5b505af1158015610edb573d6000803e3d6000fd5b6114956124c7565b6007805460ff19168215159081179091556040517fe628f01c6f4e6340598d3a2913390db68e8859379eebff349e170f2b16baed0090600090a250565b6114da6124c7565b61ffff821660009081526009602052604090205481111561154c5760405162461bcd60e51b815260206004820152602660248201527f53696e676c65207472616e73616374696f6e206c696d6974203e204461696c79604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600860209081526040918290205482519384529083015281018290527f7babeac42ccbb33537ee421fedc4db7b5f251b5d2a3fa5c0ff4b35b2d783be879060600160405180910390a161ffff909116600090815260086020526040902055565b6115be6124c7565b816001600160a01b03167ff6019ec0a78d156d249a1ec7579e2321f6ac7521d6e1d2eacf90ba4a184dcceb826040516115fb911515815260200190565b60405180910390a26001600160a01b03919091166000908152601060205260409020805460ff1916911515919091179055565b6116366124c7565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a0823190602401602060405180830381865afa15801561167d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a19190614f0d565b9050808211156116ce5760405163cf47918160e01b81526004810183905260248101829052604401610d66565b826001600160a01b0316846001600160a01b03167f6d25be279134f4ecaa4770aff0c3d916d9e7c5ef37b65ed95dbdba411f5d54d58460405161171391815260200190565b60405180910390a361172f6001600160a01b0385168484612685565b50505050565b3330146117935760405162461bcd60e51b815260206004820152602660248201527f4e6f6e626c6f636b696e674c7a4170703a2063616c6c6572206d7573742062656044820152650204c7a4170760d41b6064820152608401610d66565b6118098686868080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8901819004810282018101909252878152899350915087908790819084018382808284376000920191909152506126ed92505050565b505050505050565b611809858585856118256020870187614bd5565b6118356040880160208901614bd5565b6118426040890189614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061277492505050565b6118846124c7565b61ffff82166000908152600c60205260409020548110156118fe5760405162461bcd60e51b815260206004820152602e60248201527f4461696c79206c696d6974203c2073696e676c6520726563656976652074726160448201526d1b9cd858dd1a5bdb881b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600d60209081526040918290205482519384529083015281018290527f95dc51094cd27cf4ee3fd0dbb50cf96f8df1629c822f5434c4a34d7eb03c97249060600160405180910390a161ffff9091166000908152600d6020526040902055565b6001602052600090815260409020805461198190614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90614e83565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b505050505081565b60075460ff16611a545760405162461bcd60e51b815260206004820152601760248201527f73656e64416e6443616c6c2069732064697361626c65640000000000000000006044820152606401610d66565b611a64888888888888888861285c565b5050505050505050565b611a766124c7565b611a7f81612900565b6007546040516001600160a01b0380841692610100900416907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd90600090a3600780546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b611aee6124c7565b611405612927565b611afe6124c7565b61ffff83166000908152600560205260408082209051611b1f908590614ff8565b9081526040805191829003602090810183206001600160401b038616600090815291522091909155611b52908390614ff8565b6040805191829003822061ffff861683526001600160401b0384166020840152917f48a980eea4ea1c540209e2f9f32a4c2edf51fab37b1d21f453868301ecb6e2ee910160405180910390a2505050565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c03573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c279190614f0d565b905090565b61ffff8116600090815260016020526040812080546060929190611c4f90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054611c7b90614e83565b8015611cc85780601f10611c9d57610100808354040283529160200191611cc8565b820191906000526020600020905b815481529060010190602001808311611cab57829003601f168201915b505050505090508051600003611d205760405162461bcd60e51b815260206004820152601d60248201527f4c7a4170703a206e6f20747275737465642070617468207265636f72640000006044820152606401610d66565b611d3b600060148351611d339190614f3c565b839190612964565b9392505050565b600080611dbf8b8b8b8b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b81528e93508d9250908c908c9081908401838280828437600092019190915250612a7192505050565b91509150995099975050505050505050565b611dd96124c7565b818130604051602001611dee93929190615014565b60408051601f1981840301815291815261ffff85166000908152600160209081529190208251611e23939192909101906144ea565b507f8c0400cfe2d1199b1a725c78960bcc2a344d869b80590d0f2bd005db15a572ce838383604051611e5793929190614f94565b60405180910390a1505050565b611e6c6124c7565b600480546001600160a01b0319166001600160a01b0383169081179091556040519081527f5db758e995a17ec1ad84bdef7e8c3293a0bd6179bcce400dff5d4c3d87db726b906020016112c9565b611ec26124c7565b6040516332fb62e760e21b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cbed8b9c90611f16908890889088908890889060040161503a565b600060405180830381600087803b158015611f3057600080fd5b505af1158015611f44573d6000803e3d6000fd5b505050505050505050565b611f576124c7565b61ffff82166000908152600d6020526040902054811115611fd15760405162461bcd60e51b815260206004820152602e60248201527f73696e676c652072656365697665207472616e73616374696f6e206c696d697460448201526d080f8811185a5b1e481b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600c60209081526040918290205482519384529083015281018290527f2c42997a938a029910a78e7c28d762b349c28e70f3a89c1fbccbb1a46020b1599060600160405180910390a161ffff9091166000908152600c6020526040902055565b61ffff86166000908152600160205260408120805461205990614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461208590614e83565b80156120d25780601f106120a7576101008083540402835291602001916120d2565b820191906000526020600020905b8154815290600101906020018083116120b557829003601f168201915b505050505090508051868690501480156120ed575060008151115b801561211557508051602082012060405161210b9088908890614eb7565b6040518091039020145b6121315760405162461bcd60e51b8152600401610d6690614ec7565b610edb878787878787612b33565b6121476124c7565b61ffff83811660008181526002602090815260408083209487168084529482529182902085905581519283528201929092529081018290527f9d5c7c0b934da8fefa9c7760c98383778a12dfbfc0c3b3106518f43fb9508ac090606001611e57565b3330146121f85760405162461bcd60e51b815260206004820152601f60248201527f4f4654436f72653a2063616c6c6572206d757374206265204f4654436f7265006044820152606401610d66565b612203308686612d49565b9350846001600160a01b03168a61ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8660405161224591815260200190565b60405180910390a3604051633fe79aed60e11b81526001600160a01b03861690637fcf35da908390612289908e908e908e908e908e908d908d908d90600401615068565b600060405180830381600088803b1580156122a357600080fd5b5087f11580156122b7573d6000803e3d6000fd5b505050505050505050505050505050565b6122d06124c7565b61ffff831660009081526001602052604090206122ee90838361456e565b507ffa41487ad5d6728f0b19276fa1eddc16558578f5109fc39d2dc33c3230470dab838383604051611e5793929190614f94565b61232a6124c7565b6001600160a01b03811661238f5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d66565b61239881612f03565b50565b604051633d7b2f6f60e21b815261ffff808616600483015284166024820152306044820152606481018290526060907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03169063f5ecbdbc90608401600060405180830381865afa15801561241b573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261244391908101906150c3565b90505b949350505050565b6000806124b15a60966366ad5c8a60e01b898989896040516024016124769493929190615130565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915230929190612f5c565b9150915081611809576118098686868685612fe6565b6000546001600160a01b036101009091041633146114055760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d66565b6000806125348484613083565b9050612446816130b4565b600080600061258d87612551886130cc565b6040805160006020820152602181019390935260c09190911b6001600160c01b0319166041830152805160298184030181526049909201905290565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb10906125e4908b90309086908b908b9060040161516e565b6040805180830381865afa158015612600573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061262491906151c2565b92509250509550959350505050565b61263b613152565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6040516001600160a01b0383166024820152604481018290526126e890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261319b565b505050565b60006126f98282613270565b905060ff81166127145761270f858585856132cc565b610f9d565b60001960ff82160161272c5761270f8585858561335c565b60405162461bcd60e51b815260206004820152601c60248201527f4f4654436f72653a20756e6b6e6f776e207061636b65742074797065000000006044820152606401610d66565b60006127828782848161356a565b61278b8561363f565b50905061279a8888888461367f565b9050600081116127e85760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006127f787612551846130cc565b9050612807888287878734613782565b86896001600160a01b03168961ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a8560405161284891815260200190565b60405180910390a450979650505050505050565b611f448888888888888080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a92506128a99150506020890189614bd5565b6128b960408a0160208b01614bd5565b6128c660408b018b614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061392792505050565b6001600160a01b038116612398576040516342bcdf7f60e11b815260040160405180910390fd5b61292f613a1c565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586126683390565b60608161297281601f614f53565b10156129b15760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b6044820152606401610d66565b6129bb8284614f53565b845110156129ff5760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b6044820152606401610d66565b606082158015612a1e5760405191506000825260208201604052612a68565b6040519150601f8416801560200281840101858101878315602002848b0101015b81831015612a57578051835260209283019201612a3f565b5050858452601f01601f1916604052505b50949350505050565b6000806000612a8b338a612a848b6130cc565b8a8a613a62565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb1090612ae2908d90309086908b908b9060040161516e565b6040805180830381865afa158015612afe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b2291906151c2565b925092505097509795505050505050565b61ffff86166000908152600560205260408082209051612b569088908890614eb7565b90815260408051602092819003830190206001600160401b03871660009081529252902054905080612bd65760405162461bcd60e51b815260206004820152602360248201527f4e6f6e626c6f636b696e674c7a4170703a206e6f2073746f726564206d65737360448201526261676560e81b6064820152608401610d66565b808383604051612be7929190614eb7565b604051809103902014612c465760405162461bcd60e51b815260206004820152602160248201527f4e6f6e626c6f636b696e674c7a4170703a20696e76616c6964207061796c6f616044820152601960fa1b6064820152608401610d66565b61ffff87166000908152600560205260408082209051612c699089908990614eb7565b90815260408051602092819003830181206001600160401b038916600090815290845282902093909355601f88018290048202830182019052868252612d01918991899089908190840183828082843760009201919091525050604080516020601f8a018190048102820181019092528881528a9350915088908890819084018382808284376000920191909152506126ed92505050565b7fc264d91f3adc5588250e1551f547752ca0cfa8f6b530d243b9f9f4cab10ea8e58787878785604051612d389594939291906151e6565b60405180910390a150505050505050565b6000612d53613a1c565b6040516370a0823160e01b81526001600160a01b0384811660048301526000917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612dbe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612de29190614f0d565b9050306001600160a01b03861603612e2d57612e286001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168585612685565b612e62565b612e626001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016868686613aa3565b6040516370a0823160e01b81526001600160a01b03858116600483015282917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612ecc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612ef09190614f0d565b612efa9190614f3c565b95945050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6000606060008060008661ffff166001600160401b03811115612f8157612f816148df565b6040519080825280601f01601f191660200182016040528015612fab576020820181803683370190505b50905060008087516020890160008d8df191503d925086831115612fcd578692505b828152826000602083013e909890975095505050505050565b8180519060200120600560008761ffff1661ffff168152602001908152602001600020856040516130179190614ff8565b9081526040805191829003602090810183206001600160401b0388166000908152915220919091557fe183f33de2837795525b4792ca4cd60535bd77c53b7e7030060bfcf5734d6b0c906130749087908790879087908790615221565b60405180910390a15050505050565b60408051602081019091526000815260405180602001604052806130ab856000015185613adb565b90529392505050565b8051600090610f1590670de0b6b3a764000090615289565b6000806130f97f000000000000000000000000000000000000000000000000000000000000000084615289565b90506001600160401b03811115610f155760405162461bcd60e51b815260206004820152601a60248201527f4f4654436f72653a20616d6f756e745344206f766572666c6f770000000000006044820152606401610d66565b60005460ff166114055760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610d66565b60006131f0826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316613ae79092919063ffffffff16565b9050805160001480613211575080806020019051810190613211919061529d565b6126e85760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610d66565b600061327d826001614f53565b835110156132c35760405162461bcd60e51b8152602060048201526013602482015272746f55696e74385f6f75744f66426f756e647360681b6044820152606401610d66565b50016001015190565b6000806132d883613af6565b90925090506001600160a01b0382166132f15761dead91505b60006132fc82613b7b565b9050613309878483613bb0565b9050826001600160a01b03168761ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8360405161334b91815260200190565b60405180910390a350505050505050565b600080600080600061336d86613c4f565b945094509450945094506000600660008b61ffff1661ffff168152602001908152602001600020896040516133a29190614ff8565b90815260408051602092819003830190206001600160401b038b166000908152925281205460ff1691506133d585613b7b565b905081613443576133e78b3083613bb0565b61ffff8c1660009081526006602052604090819020905191925060019161340f908d90614ff8565b90815260408051602092819003830190206001600160401b038d16600090815292529020805460ff19169115159190911790555b6001600160a01b0386163b61349a576040516001600160a01b03871681527f9aedf5fdba8716db3b6705ca00150643309995d4f818a249ed6dde6677e7792d9060200160405180910390a15050505050505061172f565b8a8a8a8a8a8a868a60008a6134b8578b6001600160401b03166134ba565b5a5b90506000806134ec5a609663eaffd49a60e01b8e8e8e8d8d8d8d8d6040516024016124769897969594939291906152ba565b915091508115613545578751602089012060405161ffff8d16907fb8890edbfc1c74692f527444645f95489c3703cc2df42e4a366f5d06fa6cd88490613537908e908e90869061532e565b60405180910390a250613552565b6135528b8b8b8b85612fe6565b50505050505050505050505050505050505050505050565b600061357583613d06565b61ffff808716600090815260026020908152604080832093891683529290522054909150806135e65760405162461bcd60e51b815260206004820152601a60248201527f4c7a4170703a206d696e4761734c696d6974206e6f74207365740000000000006044820152606401610d66565b6135f08382614f53565b8210156118095760405162461bcd60e51b815260206004820152601b60248201527f4c7a4170703a20676173206c696d697420697320746f6f206c6f7700000000006044820152606401610d66565b60008061366c7f00000000000000000000000000000000000000000000000000000000000000008461535c565b90506136788184614f3c565b9150915091565b6000613689613a1c565b6001600160a01b03851633146136ec5760405162461bcd60e51b815260206004820152602260248201527f50726f78794f46543a206f776e6572206973206e6f742073656e642063616c6c60448201526132b960f11b6064820152608401610d66565b6136f7858584613d62565b604051632770a7eb60e21b81526001600160a01b038681166004830152602482018490527f00000000000000000000000000000000000000000000000000000000000000001690639dc29fac90604401600060405180830381600087803b15801561376157600080fd5b505af1158015613775573d6000803e3d6000fd5b5093979650505050505050565b61ffff8616600090815260016020526040812080546137a090614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546137cc90614e83565b80156138195780601f106137ee57610100808354040283529160200191613819565b820191906000526020600020905b8154815290600101906020018083116137fc57829003601f168201915b50505050509050805160000361388a5760405162461bcd60e51b815260206004820152603060248201527f4c7a4170703a2064657374696e6174696f6e20636861696e206973206e6f742060448201526f61207472757374656420736f7572636560801b6064820152608401610d66565b613895878751613f84565b60405162c5803160e81b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063c58031009084906138ec908b9086908c908c908c908c90600401615370565b6000604051808303818588803b15801561390557600080fd5b505af1158015613919573d6000803e3d6000fd5b505050505050505050505050565b600061393f896001846001600160401b03891661356a565b6139488761363f565b5090506139578a8a8a8461367f565b9050600081116139a55760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006139b5338a612a84856130cc565b90506139c58a8287878734613782565b888b6001600160a01b03168b61ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a85604051613a0691815260200190565b60405180910390a4509998505050505050505050565b60005460ff16156114055760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610d66565b6060600185856001600160a01b0389168587604051602001613a89969594939291906153d7565b604051602081830303815290604052905095945050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261172f9085906323b872dd60e01b906084016126b1565b6000611d3b8284615438565b60606124468484600085613ff5565b60008080613b048482613270565b60ff16148015613b15575082516029145b613b5c5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613b6783600d6140d0565b9150613b74836021614135565b9050915091565b6000610f157f00000000000000000000000000000000000000000000000000000000000000006001600160401b038416615438565b6000613bba613a1c565b613bc5838584614192565b6040516340c10f1960e01b81526001600160a01b038481166004830152602482018490527f000000000000000000000000000000000000000000000000000000000000000016906340c10f1990604401600060405180830381600087803b158015613c2f57600080fd5b505af1158015613c43573d6000803e3d6000fd5b50939695505050505050565b600080806060816001613c628783613270565b60ff1614613cad5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613cb886600d6140d0565b9350613cc5866021614135565b9250613cd28660296143b4565b9450613cdf866049614135565b9050613cfb6051808851613cf39190614f3c565b889190612964565b915091939590929450565b6000602282511015613d5a5760405162461bcd60e51b815260206004820152601c60248201527f4c7a4170703a20696e76616c69642061646170746572506172616d73000000006044820152606401610d66565b506022015190565b6001600160a01b03831660009081526010602052604090205460ff168015613d8a5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015613e17573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e3b9190614f0d565b90529050613e498185612527565b61ffff86166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054939550429390919081871115613ed25760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b62015180613ee08587614f3c565b1115613f045761ffff8a166000908152600b60205260409020859055869250613f11565b613f0e8784614f53565b92505b80831115613f615760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600a602052604090209690965550505050505050565b61ffff821660009081526003602052604081205490819003613fa557506127105b808211156126e85760405162461bcd60e51b815260206004820181905260248201527f4c7a4170703a207061796c6f61642073697a6520697320746f6f206c617267656044820152606401610d66565b6060824710156140565760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610d66565b600080866001600160a01b031685876040516140729190614ff8565b60006040518083038185875af1925050503d80600081146140af576040519150601f19603f3d011682016040523d82523d6000602084013e6140b4565b606091505b50915091506140c587838387614412565b979650505050505050565b60006140dd826014614f53565b835110156141255760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b6044820152606401610d66565b500160200151600160601b900490565b6000614142826008614f53565b835110156141895760405162461bcd60e51b8152602060048201526014602482015273746f55696e7436345f6f75744f66426f756e647360601b6044820152606401610d66565b50016008015190565b6001600160a01b03831660009081526010602052604090205460ff1680156141ba5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015614247573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061426b9190614f0d565b905290506142798185612527565b61ffff86166000908152600f6020908152604080832054600e835281842054600c845282852054600d90945291909320549395504293909190818711156143025760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b620151806143108587614f3c565b11156143345761ffff8a166000908152600f60205260409020859055869250614341565b61433e8784614f53565b92505b808311156143915760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600e602052604090209690965550505050505050565b60006143c1826020614f53565b835110156144095760405162461bcd60e51b8152602060048201526015602482015274746f427974657333325f6f75744f66426f756e647360581b6044820152606401610d66565b50016020015190565b6060831561448157825160000361447a576001600160a01b0385163b61447a5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610d66565b5081612446565b61244683838151156144965781518083602001fd5b8060405162461bcd60e51b8152600401610d669190614b10565b5080546144bc90614e83565b6000825580601f106144cc575050565b601f01602090049060005260206000209081019061239891906145e2565b8280546144f690614e83565b90600052602060002090601f016020900481019282614518576000855561455e565b82601f1061453157805160ff191683800117855561455e565b8280016001018555821561455e579182015b8281111561455e578251825591602001919060010190614543565b5061456a9291506145e2565b5090565b82805461457a90614e83565b90600052602060002090601f01602090048101928261459c576000855561455e565b82601f106145b55782800160ff1982351617855561455e565b8280016001018555821561455e579182015b8281111561455e5782358255916020019190600101906145c7565b5b8082111561456a57600081556001016145e3565b803561ffff8116811461460957600080fd5b919050565b60008083601f84011261462057600080fd5b5081356001600160401b0381111561463757600080fd5b60208301915083602082850101111561464f57600080fd5b9250929050565b80356001600160401b038116811461460957600080fd5b6000806000806000806080878903121561468657600080fd5b61468f876145f7565b955060208701356001600160401b03808211156146ab57600080fd5b6146b78a838b0161460e565b90975095508591506146cb60408a01614656565b945060608901359150808211156146e157600080fd5b506146ee89828a0161460e565b979a9699509497509295939492505050565b60006020828403121561471257600080fd5b81356001600160e01b031981168114611d3b57600080fd5b60006020828403121561473c57600080fd5b611d3b826145f7565b6000806040838503121561475857600080fd5b614761836145f7565b946020939093013593505050565b6001600160a01b038116811461239857600080fd5b60008060006060848603121561479957600080fd5b83356147a48161476f565b92506147b2602085016145f7565b9150604084013590509250925092565b801515811461239857600080fd5b60008060008060008060a087890312156147e957600080fd5b6147f2876145f7565b955060208701359450604087013593506060870135614810816147c2565b925060808701356001600160401b0381111561482b57600080fd5b6146ee89828a0161460e565b60008060006040848603121561484c57600080fd5b614855846145f7565b925060208401356001600160401b0381111561487057600080fd5b61487c8682870161460e565b9497909650939450505050565b60006020828403121561489b57600080fd5b8135611d3b816147c2565b600080604083850312156148b957600080fd5b82356148c48161476f565b915060208301356148d4816147c2565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561491d5761491d6148df565b604052919050565b60006001600160401b0382111561493e5761493e6148df565b50601f01601f191660200190565b60008060006060848603121561496157600080fd5b61496a846145f7565b925060208401356001600160401b0381111561498557600080fd5b8401601f8101861361499657600080fd5b80356149a96149a482614925565b6148f5565b8181528760208385010111156149be57600080fd5b816020840160208301376000602083830101528094505050506149e360408501614656565b90509250925092565b600080600060608486031215614a0157600080fd5b8335614a0c8161476f565b92506020840135614a1c8161476f565b929592945050506040919091013590565b600060608284031215614a3f57600080fd5b50919050565b600080600080600060a08688031215614a5d57600080fd5b8535614a688161476f565b9450614a76602087016145f7565b9350604086013592506060860135915060808601356001600160401b03811115614a9f57600080fd5b614aab88828901614a2d565b9150509295509295909350565b60005b83811015614ad3578181015183820152602001614abb565b8381111561172f5750506000910152565b60008151808452614afc816020860160208601614ab8565b601f01601f19169290920160200192915050565b602081526000611d3b6020830184614ae4565b60008060008060008060008060e0898b031215614b3f57600080fd5b8835614b4a8161476f565b9750614b5860208a016145f7565b9650604089013595506060890135945060808901356001600160401b0380821115614b8257600080fd5b614b8e8c838d0161460e565b9096509450849150614ba260a08c01614656565b935060c08b0135915080821115614bb857600080fd5b50614bc58b828c01614a2d565b9150509295985092959890939650565b600060208284031215614be757600080fd5b8135611d3b8161476f565b60008060408385031215614c0557600080fd5b614c0e836145f7565b9150614c1c602084016145f7565b90509250929050565b600080600080600080600080600060e08a8c031215614c4357600080fd5b614c4c8a6145f7565b985060208a0135975060408a0135965060608a01356001600160401b0380821115614c7657600080fd5b614c828d838e0161460e565b9098509650869150614c9660808d01614656565b955060a08c01359150614ca8826147c2565b90935060c08b01359080821115614cbe57600080fd5b50614ccb8c828d0161460e565b915080935050809150509295985092959850929598565b600080600080600060808688031215614cfa57600080fd5b614d03866145f7565b9450614d11602087016145f7565b93506040860135925060608601356001600160401b03811115614d3357600080fd5b614d3f8882890161460e565b969995985093965092949392505050565b600080600060608486031215614d6557600080fd5b6147a4846145f7565b6000806000806000806000806000806101008b8d031215614d8e57600080fd5b614d978b6145f7565b995060208b01356001600160401b0380821115614db357600080fd5b614dbf8e838f0161460e565b909b509950899150614dd360408e01614656565b985060608d0135975060808d01359150614dec8261476f565b90955060a08c0135945060c08c01359080821115614e0957600080fd5b50614e168d828e0161460e565b9150809450508092505060e08b013590509295989b9194979a5092959850565b60008060008060808587031215614e4c57600080fd5b614e55856145f7565b9350614e63602086016145f7565b92506040850135614e738161476f565b9396929550929360600135925050565b600181811c90821680614e9757607f821691505b602082108103614a3f57634e487b7160e01b600052602260045260246000fd5b8183823760009101908152919050565b60208082526026908201527f4c7a4170703a20696e76616c696420736f757263652073656e64696e6720636f6040820152651b9d1c9858dd60d21b606082015260800190565b600060208284031215614f1f57600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b600082821015614f4e57614f4e614f26565b500390565b60008219821115614f6657614f66614f26565b500190565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff84168152604060208201526000612443604083018486614f6b565b6000808335601e19843603018112614fc957600080fd5b8301803591506001600160401b03821115614fe357600080fd5b60200191503681900382131561464f57600080fd5b6000825161500a818460208701614ab8565b9190910192915050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b600061ffff8088168352808716602084015250846040830152608060608301526140c5608083018486614f6b565b61ffff8916815260c06020820152600061508660c08301898b614f6b565b6001600160401b038816604084015286606084015285608084015282810360a08401526150b4818587614f6b565b9b9a5050505050505050505050565b6000602082840312156150d557600080fd5b81516001600160401b038111156150eb57600080fd5b8201601f810184136150fc57600080fd5b805161510a6149a482614925565b81815285602083850101111561511f57600080fd5b612efa826020830160208601614ab8565b61ffff8516815260806020820152600061514d6080830186614ae4565b6001600160401b038516604084015282810360608401526140c58185614ae4565b61ffff861681526001600160a01b038516602082015260a06040820181905260009061519c90830186614ae4565b841515606084015282810360808401526151b68185614ae4565b98975050505050505050565b600080604083850312156151d557600080fd5b505080516020909101519092909150565b61ffff86168152608060208201526000615204608083018688614f6b565b6001600160401b0394909416604083015250606001529392505050565b61ffff8616815260a06020820152600061523e60a0830187614ae4565b6001600160401b0386166040840152828103606084015261525f8186614ae4565b905082810360808401526151b68185614ae4565b634e487b7160e01b600052601260045260246000fd5b60008261529857615298615273565b500490565b6000602082840312156152af57600080fd5b8151611d3b816147c2565b600061010061ffff8b1683528060208401526152d88184018b614ae4565b6001600160401b038a166040850152606084018990526001600160a01b038816608085015260a0840187905283810360c085015290506153188186614ae4565b9150508260e08301529998505050505050505050565b6060815260006153416060830186614ae4565b6001600160401b039490941660208301525060400152919050565b60008261536b5761536b615273565b500690565b61ffff8716815260c06020820152600061538d60c0830188614ae4565b828103604084015261539f8188614ae4565b6001600160a01b0387811660608601528616608085015283810360a085015290506153ca8185614ae4565b9998505050505050505050565b60ff60f81b8760f81b16815285600182015260006001600160401b0360c01b808760c01b166021840152856029840152808560c01b166049840152508251615426816051850160208701614ab8565b91909101605101979650505050505050565b600081600019048311821515161561545257615452614f26565b50029056fea264697066735822122002e85e39cd4c45156c727cd464d515ec143b5814676650286110a986cc477f2264736f6c634300080d0033", + "deployedBytecode": "0x6080604052600436106103b75760003560e01c80637dc0d1d0116101f2578063baf3292d1161010d578063df2a5b3b116100a0578063f2fde38b1161006f578063f2fde38b14610c52578063f5ecbdbc14610c72578063fc0c546a14610c92578063fdff235b14610cc557600080fd5b8063df2a5b3b14610bdd578063e6a20ae614610bfd578063eaffd49a14610c12578063eb8d72b714610c3257600080fd5b8063cc01e9b6116100dc578063cc01e9b614610b50578063cc7015ae14610b70578063d1deba1f14610b9d578063d708a46814610bb057600080fd5b8063baf3292d14610ae0578063c1e9132e14610b00578063c446183414610b1a578063cbed8b9c14610b3057600080fd5b806393a61d6c116101855780639f38369a116101545780639f38369a14610a4c578063a4c51df514610a6c578063a6c3d16514610a8c578063b353aaa714610aac57600080fd5b806393a61d6c1461097d578063950c8a74146109aa5780639b19251a146109ca5780639bdb9812146109fa57600080fd5b80638cfd8f5c116101c15780638cfd8f5c146108e05780638da5cb5b14610918578063904365671461093b5780639358928b1461096857600080fd5b80637dc0d1d01461083a5780638456cb591461087757806384e69c691461088c578063857749b0146108ac57600080fd5b80634c42899a116102e257806364aff9ec11610275578063715018a611610244578063715018a6146107ce5780637533d788146107da57806376203b48146108075780637adbf9731461081a57600080fd5b806364aff9ec1461075b57806366ad5c8a1461077b578063695ef6bf1461079b57806369c1e7b8146107ae57600080fd5b806353489d6c116102b157806353489d6c146106b457806353d6fd59146106d45780635b8c41e6146106f45780635c975abb1461074357600080fd5b80634c42899a146106135780634cec62561461063a5780634ed2c662146106675780634f4ba0f41461068757600080fd5b80632dbbec081161035a5780633f1f4fa4116103295780633f1f4fa41461059c5780633f4ba83a146105c957806342d65a8d146105de57806344770515146105fe57600080fd5b80632dbbec08146104ec578063365260b41461050c5780633c4ec39b146105415780633d8b38f61461057c57600080fd5b80630df37483116103965780630df374831461043357806310ddb13714610453578063182b4b89146104735780632488eec8146104cc57600080fd5b80621d3567146103bc57806301ffc9a7146103de57806307e0db1714610413575b600080fd5b3480156103c857600080fd5b506103dc6103d736600461466d565b610cf2565b005b3480156103ea57600080fd5b506103fe6103f9366004614700565b610ee4565b60405190151581526020015b60405180910390f35b34801561041f57600080fd5b506103dc61042e36600461472a565b610f1b565b34801561043f57600080fd5b506103dc61044e366004614745565b610fa4565b34801561045f57600080fd5b506103dc61046e36600461472a565b610fc3565b34801561047f57600080fd5b5061049361048e366004614784565b61101b565b6040805197151588526020880196909652948601939093526060850191909152608084015260a0830152151560c082015260e00161040a565b3480156104d857600080fd5b506103dc6104e7366004614745565b611191565b3480156104f857600080fd5b506103dc61050736600461472a565b611275565b34801561051857600080fd5b5061052c6105273660046147d0565b6112d4565b6040805192835260208301919091520161040a565b34801561054d57600080fd5b5061056e61055c36600461472a565b600d6020526000908152604090205481565b60405190815260200161040a565b34801561058857600080fd5b506103fe610597366004614837565b611329565b3480156105a857600080fd5b5061056e6105b736600461472a565b60036020526000908152604090205481565b3480156105d557600080fd5b506103dc6113f5565b3480156105ea57600080fd5b506103dc6105f9366004614837565b611407565b34801561060a57600080fd5b5061056e600081565b34801561061f57600080fd5b50610628600081565b60405160ff909116815260200161040a565b34801561064657600080fd5b5061056e61065536600461472a565b600a6020526000908152604090205481565b34801561067357600080fd5b506103dc610682366004614889565b61148d565b34801561069357600080fd5b5061056e6106a236600461472a565b60096020526000908152604090205481565b3480156106c057600080fd5b506103dc6106cf366004614745565b6114d2565b3480156106e057600080fd5b506103dc6106ef3660046148a6565b6115b6565b34801561070057600080fd5b5061056e61070f36600461494c565b6005602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205481565b34801561074f57600080fd5b5060005460ff166103fe565b34801561076757600080fd5b506103dc6107763660046149ec565b61162e565b34801561078757600080fd5b506103dc61079636600461466d565b611735565b6103dc6107a9366004614a45565b611811565b3480156107ba57600080fd5b506103dc6107c9366004614745565b61187c565b3480156103dc57600080fd5b3480156107e657600080fd5b506107fa6107f536600461472a565b611968565b60405161040a9190614b10565b6103dc610815366004614b23565b611a02565b34801561082657600080fd5b506103dc610835366004614bd5565b611a6e565b34801561084657600080fd5b5060075461085f9061010090046001600160a01b031681565b6040516001600160a01b03909116815260200161040a565b34801561088357600080fd5b506103dc611ae6565b34801561089857600080fd5b506103dc6108a736600461494c565b611af6565b3480156108b857600080fd5b506106287f000000000000000000000000000000000000000000000000000000000000000081565b3480156108ec57600080fd5b5061056e6108fb366004614bf2565b600260209081526000928352604080842090915290825290205481565b34801561092457600080fd5b5060005461010090046001600160a01b031661085f565b34801561094757600080fd5b5061056e61095636600461472a565b600c6020526000908152604090205481565b34801561097457600080fd5b5061056e611ba3565b34801561098957600080fd5b5061056e61099836600461472a565b600b6020526000908152604090205481565b3480156109b657600080fd5b5060045461085f906001600160a01b031681565b3480156109d657600080fd5b506103fe6109e5366004614bd5565b60106020526000908152604090205460ff1681565b348015610a0657600080fd5b506103fe610a1536600461494c565b6006602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205460ff1681565b348015610a5857600080fd5b506107fa610a6736600461472a565b611c2c565b348015610a7857600080fd5b5061052c610a87366004614c25565b611d42565b348015610a9857600080fd5b506103dc610aa7366004614837565b611dd1565b348015610ab857600080fd5b5061085f7f000000000000000000000000000000000000000000000000000000000000000081565b348015610aec57600080fd5b506103dc610afb366004614bd5565b611e64565b348015610b0c57600080fd5b506007546103fe9060ff1681565b348015610b2657600080fd5b5061056e61271081565b348015610b3c57600080fd5b506103dc610b4b366004614ce2565b611eba565b348015610b5c57600080fd5b506103dc610b6b366004614745565b611f4f565b348015610b7c57600080fd5b5061056e610b8b36600461472a565b60086020526000908152604090205481565b6103dc610bab36600461466d565b61203b565b348015610bbc57600080fd5b5061056e610bcb36600461472a565b600e6020526000908152604090205481565b348015610be957600080fd5b506103dc610bf8366004614d50565b61213f565b348015610c0957600080fd5b50610628600181565b348015610c1e57600080fd5b506103dc610c2d366004614d6e565b6121a9565b348015610c3e57600080fd5b506103dc610c4d366004614837565b6122c8565b348015610c5e57600080fd5b506103dc610c6d366004614bd5565b612322565b348015610c7e57600080fd5b506107fa610c8d366004614e36565b61239b565b348015610c9e57600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061085f565b348015610cd157600080fd5b5061056e610ce036600461472a565b600f6020526000908152604090205481565b337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031614610d6f5760405162461bcd60e51b815260206004820152601e60248201527f4c7a4170703a20696e76616c696420656e64706f696e742063616c6c6572000060448201526064015b60405180910390fd5b61ffff861660009081526001602052604081208054610d8d90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054610db990614e83565b8015610e065780601f10610ddb57610100808354040283529160200191610e06565b820191906000526020600020905b815481529060010190602001808311610de957829003601f168201915b50505050509050805186869050148015610e21575060008151115b8015610e49575080516020820120604051610e3f9088908890614eb7565b6040518091039020145b610e655760405162461bcd60e51b8152600401610d6690614ec7565b610edb8787878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8a018190048102820181019092528881528a93509150889088908190840183828082843760009201919091525061244e92505050565b50505050505050565b60006001600160e01b03198216631f7ecdf760e01b1480610f1557506301ffc9a760e01b6001600160e01b03198316145b92915050565b610f236124c7565b6040516307e0db1760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906307e0db17906024015b600060405180830381600087803b158015610f8957600080fd5b505af1158015610f9d573d6000803e3d6000fd5b5050505050565b610fac6124c7565b61ffff909116600090815260036020526040902055565b610fcb6124c7565b6040516310ddb13760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906310ddb13790602401610f6f565b6001600160a01b03838116600090815260106020908152604080832054815192830190915260075492938493849384938493849360ff909216928492909182916101009004166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156110cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110ef9190614f0d565b905290506110fd818a612527565b61ffff8b166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054919a509098509196509094509250426201518061114b8583614f3c565b111561115c57859450809350611169565b6111668686614f53565b94505b828061118057508786111580156111805750868511155b985050509397509397509397909450565b6111996124c7565b61ffff821660009081526008602052604090205481101561120b5760405162461bcd60e51b815260206004820152602660248201527f4461696c79206c696d6974203c2073696e676c65207472616e73616374696f6e604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600960209081526040918290205482519384529083015281018290527f4dd31065e259d5284e44d1f9265710da72eafcf78dc925e3881189fc3b71f6939060600160405180910390a161ffff909116600090815260096020526040902055565b61127d6124c7565b61ffff81166000908152600160205260408120611299916144b0565b60405161ffff821681527f6d5075c81d4d9e75bec6052f4e44f58f8a8cf1327544addbbf015fb06f83bd37906020015b60405180910390a150565b60008061131a8888888888888080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061253f92505050565b91509150965096945050505050565b61ffff83166000908152600160205260408120805482919061134a90614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461137690614e83565b80156113c35780601f10611398576101008083540402835291602001916113c3565b820191906000526020600020905b8154815290600101906020018083116113a657829003601f168201915b5050505050905083836040516113da929190614eb7565b60405180910390208180519060200120149150509392505050565b6113fd6124c7565b611405612633565b565b61140f6124c7565b6040516342d65a8d60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906342d65a8d9061145f90869086908690600401614f94565b600060405180830381600087803b15801561147957600080fd5b505af1158015610edb573d6000803e3d6000fd5b6114956124c7565b6007805460ff19168215159081179091556040517fe628f01c6f4e6340598d3a2913390db68e8859379eebff349e170f2b16baed0090600090a250565b6114da6124c7565b61ffff821660009081526009602052604090205481111561154c5760405162461bcd60e51b815260206004820152602660248201527f53696e676c65207472616e73616374696f6e206c696d6974203e204461696c79604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600860209081526040918290205482519384529083015281018290527f7babeac42ccbb33537ee421fedc4db7b5f251b5d2a3fa5c0ff4b35b2d783be879060600160405180910390a161ffff909116600090815260086020526040902055565b6115be6124c7565b816001600160a01b03167ff6019ec0a78d156d249a1ec7579e2321f6ac7521d6e1d2eacf90ba4a184dcceb826040516115fb911515815260200190565b60405180910390a26001600160a01b03919091166000908152601060205260409020805460ff1916911515919091179055565b6116366124c7565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a0823190602401602060405180830381865afa15801561167d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a19190614f0d565b9050808211156116ce5760405163cf47918160e01b81526004810183905260248101829052604401610d66565b826001600160a01b0316846001600160a01b03167f6d25be279134f4ecaa4770aff0c3d916d9e7c5ef37b65ed95dbdba411f5d54d58460405161171391815260200190565b60405180910390a361172f6001600160a01b0385168484612685565b50505050565b3330146117935760405162461bcd60e51b815260206004820152602660248201527f4e6f6e626c6f636b696e674c7a4170703a2063616c6c6572206d7573742062656044820152650204c7a4170760d41b6064820152608401610d66565b6118098686868080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8901819004810282018101909252878152899350915087908790819084018382808284376000920191909152506126ed92505050565b505050505050565b611809858585856118256020870187614bd5565b6118356040880160208901614bd5565b6118426040890189614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061277492505050565b6118846124c7565b61ffff82166000908152600c60205260409020548110156118fe5760405162461bcd60e51b815260206004820152602e60248201527f4461696c79206c696d6974203c2073696e676c6520726563656976652074726160448201526d1b9cd858dd1a5bdb881b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600d60209081526040918290205482519384529083015281018290527f95dc51094cd27cf4ee3fd0dbb50cf96f8df1629c822f5434c4a34d7eb03c97249060600160405180910390a161ffff9091166000908152600d6020526040902055565b6001602052600090815260409020805461198190614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90614e83565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b505050505081565b60075460ff16611a545760405162461bcd60e51b815260206004820152601760248201527f73656e64416e6443616c6c2069732064697361626c65640000000000000000006044820152606401610d66565b611a64888888888888888861285c565b5050505050505050565b611a766124c7565b611a7f81612900565b6007546040516001600160a01b0380841692610100900416907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd90600090a3600780546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b611aee6124c7565b611405612927565b611afe6124c7565b61ffff83166000908152600560205260408082209051611b1f908590614ff8565b9081526040805191829003602090810183206001600160401b038616600090815291522091909155611b52908390614ff8565b6040805191829003822061ffff861683526001600160401b0384166020840152917f48a980eea4ea1c540209e2f9f32a4c2edf51fab37b1d21f453868301ecb6e2ee910160405180910390a2505050565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c03573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c279190614f0d565b905090565b61ffff8116600090815260016020526040812080546060929190611c4f90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054611c7b90614e83565b8015611cc85780601f10611c9d57610100808354040283529160200191611cc8565b820191906000526020600020905b815481529060010190602001808311611cab57829003601f168201915b505050505090508051600003611d205760405162461bcd60e51b815260206004820152601d60248201527f4c7a4170703a206e6f20747275737465642070617468207265636f72640000006044820152606401610d66565b611d3b600060148351611d339190614f3c565b839190612964565b9392505050565b600080611dbf8b8b8b8b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b81528e93508d9250908c908c9081908401838280828437600092019190915250612a7192505050565b91509150995099975050505050505050565b611dd96124c7565b818130604051602001611dee93929190615014565b60408051601f1981840301815291815261ffff85166000908152600160209081529190208251611e23939192909101906144ea565b507f8c0400cfe2d1199b1a725c78960bcc2a344d869b80590d0f2bd005db15a572ce838383604051611e5793929190614f94565b60405180910390a1505050565b611e6c6124c7565b600480546001600160a01b0319166001600160a01b0383169081179091556040519081527f5db758e995a17ec1ad84bdef7e8c3293a0bd6179bcce400dff5d4c3d87db726b906020016112c9565b611ec26124c7565b6040516332fb62e760e21b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cbed8b9c90611f16908890889088908890889060040161503a565b600060405180830381600087803b158015611f3057600080fd5b505af1158015611f44573d6000803e3d6000fd5b505050505050505050565b611f576124c7565b61ffff82166000908152600d6020526040902054811115611fd15760405162461bcd60e51b815260206004820152602e60248201527f73696e676c652072656365697665207472616e73616374696f6e206c696d697460448201526d080f8811185a5b1e481b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600c60209081526040918290205482519384529083015281018290527f2c42997a938a029910a78e7c28d762b349c28e70f3a89c1fbccbb1a46020b1599060600160405180910390a161ffff9091166000908152600c6020526040902055565b61ffff86166000908152600160205260408120805461205990614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461208590614e83565b80156120d25780601f106120a7576101008083540402835291602001916120d2565b820191906000526020600020905b8154815290600101906020018083116120b557829003601f168201915b505050505090508051868690501480156120ed575060008151115b801561211557508051602082012060405161210b9088908890614eb7565b6040518091039020145b6121315760405162461bcd60e51b8152600401610d6690614ec7565b610edb878787878787612b33565b6121476124c7565b61ffff83811660008181526002602090815260408083209487168084529482529182902085905581519283528201929092529081018290527f9d5c7c0b934da8fefa9c7760c98383778a12dfbfc0c3b3106518f43fb9508ac090606001611e57565b3330146121f85760405162461bcd60e51b815260206004820152601f60248201527f4f4654436f72653a2063616c6c6572206d757374206265204f4654436f7265006044820152606401610d66565b612203308686612d49565b9350846001600160a01b03168a61ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8660405161224591815260200190565b60405180910390a3604051633fe79aed60e11b81526001600160a01b03861690637fcf35da908390612289908e908e908e908e908e908d908d908d90600401615068565b600060405180830381600088803b1580156122a357600080fd5b5087f11580156122b7573d6000803e3d6000fd5b505050505050505050505050505050565b6122d06124c7565b61ffff831660009081526001602052604090206122ee90838361456e565b507ffa41487ad5d6728f0b19276fa1eddc16558578f5109fc39d2dc33c3230470dab838383604051611e5793929190614f94565b61232a6124c7565b6001600160a01b03811661238f5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d66565b61239881612f03565b50565b604051633d7b2f6f60e21b815261ffff808616600483015284166024820152306044820152606481018290526060907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03169063f5ecbdbc90608401600060405180830381865afa15801561241b573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261244391908101906150c3565b90505b949350505050565b6000806124b15a60966366ad5c8a60e01b898989896040516024016124769493929190615130565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915230929190612f5c565b9150915081611809576118098686868685612fe6565b6000546001600160a01b036101009091041633146114055760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d66565b6000806125348484613083565b9050612446816130b4565b600080600061258d87612551886130cc565b6040805160006020820152602181019390935260c09190911b6001600160c01b0319166041830152805160298184030181526049909201905290565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb10906125e4908b90309086908b908b9060040161516e565b6040805180830381865afa158015612600573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061262491906151c2565b92509250509550959350505050565b61263b613152565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6040516001600160a01b0383166024820152604481018290526126e890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261319b565b505050565b60006126f98282613270565b905060ff81166127145761270f858585856132cc565b610f9d565b60001960ff82160161272c5761270f8585858561335c565b60405162461bcd60e51b815260206004820152601c60248201527f4f4654436f72653a20756e6b6e6f776e207061636b65742074797065000000006044820152606401610d66565b60006127828782848161356a565b61278b8561363f565b50905061279a8888888461367f565b9050600081116127e85760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006127f787612551846130cc565b9050612807888287878734613782565b86896001600160a01b03168961ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a8560405161284891815260200190565b60405180910390a450979650505050505050565b611f448888888888888080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a92506128a99150506020890189614bd5565b6128b960408a0160208b01614bd5565b6128c660408b018b614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061392792505050565b6001600160a01b038116612398576040516342bcdf7f60e11b815260040160405180910390fd5b61292f613a1c565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586126683390565b60608161297281601f614f53565b10156129b15760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b6044820152606401610d66565b6129bb8284614f53565b845110156129ff5760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b6044820152606401610d66565b606082158015612a1e5760405191506000825260208201604052612a68565b6040519150601f8416801560200281840101858101878315602002848b0101015b81831015612a57578051835260209283019201612a3f565b5050858452601f01601f1916604052505b50949350505050565b6000806000612a8b338a612a848b6130cc565b8a8a613a62565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb1090612ae2908d90309086908b908b9060040161516e565b6040805180830381865afa158015612afe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b2291906151c2565b925092505097509795505050505050565b61ffff86166000908152600560205260408082209051612b569088908890614eb7565b90815260408051602092819003830190206001600160401b03871660009081529252902054905080612bd65760405162461bcd60e51b815260206004820152602360248201527f4e6f6e626c6f636b696e674c7a4170703a206e6f2073746f726564206d65737360448201526261676560e81b6064820152608401610d66565b808383604051612be7929190614eb7565b604051809103902014612c465760405162461bcd60e51b815260206004820152602160248201527f4e6f6e626c6f636b696e674c7a4170703a20696e76616c6964207061796c6f616044820152601960fa1b6064820152608401610d66565b61ffff87166000908152600560205260408082209051612c699089908990614eb7565b90815260408051602092819003830181206001600160401b038916600090815290845282902093909355601f88018290048202830182019052868252612d01918991899089908190840183828082843760009201919091525050604080516020601f8a018190048102820181019092528881528a9350915088908890819084018382808284376000920191909152506126ed92505050565b7fc264d91f3adc5588250e1551f547752ca0cfa8f6b530d243b9f9f4cab10ea8e58787878785604051612d389594939291906151e6565b60405180910390a150505050505050565b6000612d53613a1c565b6040516370a0823160e01b81526001600160a01b0384811660048301526000917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612dbe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612de29190614f0d565b9050306001600160a01b03861603612e2d57612e286001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168585612685565b612e62565b612e626001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016868686613aa3565b6040516370a0823160e01b81526001600160a01b03858116600483015282917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612ecc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612ef09190614f0d565b612efa9190614f3c565b95945050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6000606060008060008661ffff166001600160401b03811115612f8157612f816148df565b6040519080825280601f01601f191660200182016040528015612fab576020820181803683370190505b50905060008087516020890160008d8df191503d925086831115612fcd578692505b828152826000602083013e909890975095505050505050565b8180519060200120600560008761ffff1661ffff168152602001908152602001600020856040516130179190614ff8565b9081526040805191829003602090810183206001600160401b0388166000908152915220919091557fe183f33de2837795525b4792ca4cd60535bd77c53b7e7030060bfcf5734d6b0c906130749087908790879087908790615221565b60405180910390a15050505050565b60408051602081019091526000815260405180602001604052806130ab856000015185613adb565b90529392505050565b8051600090610f1590670de0b6b3a764000090615289565b6000806130f97f000000000000000000000000000000000000000000000000000000000000000084615289565b90506001600160401b03811115610f155760405162461bcd60e51b815260206004820152601a60248201527f4f4654436f72653a20616d6f756e745344206f766572666c6f770000000000006044820152606401610d66565b60005460ff166114055760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610d66565b60006131f0826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316613ae79092919063ffffffff16565b9050805160001480613211575080806020019051810190613211919061529d565b6126e85760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610d66565b600061327d826001614f53565b835110156132c35760405162461bcd60e51b8152602060048201526013602482015272746f55696e74385f6f75744f66426f756e647360681b6044820152606401610d66565b50016001015190565b6000806132d883613af6565b90925090506001600160a01b0382166132f15761dead91505b60006132fc82613b7b565b9050613309878483613bb0565b9050826001600160a01b03168761ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8360405161334b91815260200190565b60405180910390a350505050505050565b600080600080600061336d86613c4f565b945094509450945094506000600660008b61ffff1661ffff168152602001908152602001600020896040516133a29190614ff8565b90815260408051602092819003830190206001600160401b038b166000908152925281205460ff1691506133d585613b7b565b905081613443576133e78b3083613bb0565b61ffff8c1660009081526006602052604090819020905191925060019161340f908d90614ff8565b90815260408051602092819003830190206001600160401b038d16600090815292529020805460ff19169115159190911790555b6001600160a01b0386163b61349a576040516001600160a01b03871681527f9aedf5fdba8716db3b6705ca00150643309995d4f818a249ed6dde6677e7792d9060200160405180910390a15050505050505061172f565b8a8a8a8a8a8a868a60008a6134b8578b6001600160401b03166134ba565b5a5b90506000806134ec5a609663eaffd49a60e01b8e8e8e8d8d8d8d8d6040516024016124769897969594939291906152ba565b915091508115613545578751602089012060405161ffff8d16907fb8890edbfc1c74692f527444645f95489c3703cc2df42e4a366f5d06fa6cd88490613537908e908e90869061532e565b60405180910390a250613552565b6135528b8b8b8b85612fe6565b50505050505050505050505050505050505050505050565b600061357583613d06565b61ffff808716600090815260026020908152604080832093891683529290522054909150806135e65760405162461bcd60e51b815260206004820152601a60248201527f4c7a4170703a206d696e4761734c696d6974206e6f74207365740000000000006044820152606401610d66565b6135f08382614f53565b8210156118095760405162461bcd60e51b815260206004820152601b60248201527f4c7a4170703a20676173206c696d697420697320746f6f206c6f7700000000006044820152606401610d66565b60008061366c7f00000000000000000000000000000000000000000000000000000000000000008461535c565b90506136788184614f3c565b9150915091565b6000613689613a1c565b6001600160a01b03851633146136ec5760405162461bcd60e51b815260206004820152602260248201527f50726f78794f46543a206f776e6572206973206e6f742073656e642063616c6c60448201526132b960f11b6064820152608401610d66565b6136f7858584613d62565b604051632770a7eb60e21b81526001600160a01b038681166004830152602482018490527f00000000000000000000000000000000000000000000000000000000000000001690639dc29fac90604401600060405180830381600087803b15801561376157600080fd5b505af1158015613775573d6000803e3d6000fd5b5093979650505050505050565b61ffff8616600090815260016020526040812080546137a090614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546137cc90614e83565b80156138195780601f106137ee57610100808354040283529160200191613819565b820191906000526020600020905b8154815290600101906020018083116137fc57829003601f168201915b50505050509050805160000361388a5760405162461bcd60e51b815260206004820152603060248201527f4c7a4170703a2064657374696e6174696f6e20636861696e206973206e6f742060448201526f61207472757374656420736f7572636560801b6064820152608401610d66565b613895878751613f84565b60405162c5803160e81b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063c58031009084906138ec908b9086908c908c908c908c90600401615370565b6000604051808303818588803b15801561390557600080fd5b505af1158015613919573d6000803e3d6000fd5b505050505050505050505050565b600061393f896001846001600160401b03891661356a565b6139488761363f565b5090506139578a8a8a8461367f565b9050600081116139a55760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006139b5338a612a84856130cc565b90506139c58a8287878734613782565b888b6001600160a01b03168b61ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a85604051613a0691815260200190565b60405180910390a4509998505050505050505050565b60005460ff16156114055760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610d66565b6060600185856001600160a01b0389168587604051602001613a89969594939291906153d7565b604051602081830303815290604052905095945050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261172f9085906323b872dd60e01b906084016126b1565b6000611d3b8284615438565b60606124468484600085613ff5565b60008080613b048482613270565b60ff16148015613b15575082516029145b613b5c5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613b6783600d6140d0565b9150613b74836021614135565b9050915091565b6000610f157f00000000000000000000000000000000000000000000000000000000000000006001600160401b038416615438565b6000613bba613a1c565b613bc5838584614192565b6040516340c10f1960e01b81526001600160a01b038481166004830152602482018490527f000000000000000000000000000000000000000000000000000000000000000016906340c10f1990604401600060405180830381600087803b158015613c2f57600080fd5b505af1158015613c43573d6000803e3d6000fd5b50939695505050505050565b600080806060816001613c628783613270565b60ff1614613cad5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613cb886600d6140d0565b9350613cc5866021614135565b9250613cd28660296143b4565b9450613cdf866049614135565b9050613cfb6051808851613cf39190614f3c565b889190612964565b915091939590929450565b6000602282511015613d5a5760405162461bcd60e51b815260206004820152601c60248201527f4c7a4170703a20696e76616c69642061646170746572506172616d73000000006044820152606401610d66565b506022015190565b6001600160a01b03831660009081526010602052604090205460ff168015613d8a5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015613e17573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e3b9190614f0d565b90529050613e498185612527565b61ffff86166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054939550429390919081871115613ed25760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b62015180613ee08587614f3c565b1115613f045761ffff8a166000908152600b60205260409020859055869250613f11565b613f0e8784614f53565b92505b80831115613f615760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600a602052604090209690965550505050505050565b61ffff821660009081526003602052604081205490819003613fa557506127105b808211156126e85760405162461bcd60e51b815260206004820181905260248201527f4c7a4170703a207061796c6f61642073697a6520697320746f6f206c617267656044820152606401610d66565b6060824710156140565760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610d66565b600080866001600160a01b031685876040516140729190614ff8565b60006040518083038185875af1925050503d80600081146140af576040519150601f19603f3d011682016040523d82523d6000602084013e6140b4565b606091505b50915091506140c587838387614412565b979650505050505050565b60006140dd826014614f53565b835110156141255760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b6044820152606401610d66565b500160200151600160601b900490565b6000614142826008614f53565b835110156141895760405162461bcd60e51b8152602060048201526014602482015273746f55696e7436345f6f75744f66426f756e647360601b6044820152606401610d66565b50016008015190565b6001600160a01b03831660009081526010602052604090205460ff1680156141ba5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015614247573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061426b9190614f0d565b905290506142798185612527565b61ffff86166000908152600f6020908152604080832054600e835281842054600c845282852054600d90945291909320549395504293909190818711156143025760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b620151806143108587614f3c565b11156143345761ffff8a166000908152600f60205260409020859055869250614341565b61433e8784614f53565b92505b808311156143915760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600e602052604090209690965550505050505050565b60006143c1826020614f53565b835110156144095760405162461bcd60e51b8152602060048201526015602482015274746f427974657333325f6f75744f66426f756e647360581b6044820152606401610d66565b50016020015190565b6060831561448157825160000361447a576001600160a01b0385163b61447a5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610d66565b5081612446565b61244683838151156144965781518083602001fd5b8060405162461bcd60e51b8152600401610d669190614b10565b5080546144bc90614e83565b6000825580601f106144cc575050565b601f01602090049060005260206000209081019061239891906145e2565b8280546144f690614e83565b90600052602060002090601f016020900481019282614518576000855561455e565b82601f1061453157805160ff191683800117855561455e565b8280016001018555821561455e579182015b8281111561455e578251825591602001919060010190614543565b5061456a9291506145e2565b5090565b82805461457a90614e83565b90600052602060002090601f01602090048101928261459c576000855561455e565b82601f106145b55782800160ff1982351617855561455e565b8280016001018555821561455e579182015b8281111561455e5782358255916020019190600101906145c7565b5b8082111561456a57600081556001016145e3565b803561ffff8116811461460957600080fd5b919050565b60008083601f84011261462057600080fd5b5081356001600160401b0381111561463757600080fd5b60208301915083602082850101111561464f57600080fd5b9250929050565b80356001600160401b038116811461460957600080fd5b6000806000806000806080878903121561468657600080fd5b61468f876145f7565b955060208701356001600160401b03808211156146ab57600080fd5b6146b78a838b0161460e565b90975095508591506146cb60408a01614656565b945060608901359150808211156146e157600080fd5b506146ee89828a0161460e565b979a9699509497509295939492505050565b60006020828403121561471257600080fd5b81356001600160e01b031981168114611d3b57600080fd5b60006020828403121561473c57600080fd5b611d3b826145f7565b6000806040838503121561475857600080fd5b614761836145f7565b946020939093013593505050565b6001600160a01b038116811461239857600080fd5b60008060006060848603121561479957600080fd5b83356147a48161476f565b92506147b2602085016145f7565b9150604084013590509250925092565b801515811461239857600080fd5b60008060008060008060a087890312156147e957600080fd5b6147f2876145f7565b955060208701359450604087013593506060870135614810816147c2565b925060808701356001600160401b0381111561482b57600080fd5b6146ee89828a0161460e565b60008060006040848603121561484c57600080fd5b614855846145f7565b925060208401356001600160401b0381111561487057600080fd5b61487c8682870161460e565b9497909650939450505050565b60006020828403121561489b57600080fd5b8135611d3b816147c2565b600080604083850312156148b957600080fd5b82356148c48161476f565b915060208301356148d4816147c2565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561491d5761491d6148df565b604052919050565b60006001600160401b0382111561493e5761493e6148df565b50601f01601f191660200190565b60008060006060848603121561496157600080fd5b61496a846145f7565b925060208401356001600160401b0381111561498557600080fd5b8401601f8101861361499657600080fd5b80356149a96149a482614925565b6148f5565b8181528760208385010111156149be57600080fd5b816020840160208301376000602083830101528094505050506149e360408501614656565b90509250925092565b600080600060608486031215614a0157600080fd5b8335614a0c8161476f565b92506020840135614a1c8161476f565b929592945050506040919091013590565b600060608284031215614a3f57600080fd5b50919050565b600080600080600060a08688031215614a5d57600080fd5b8535614a688161476f565b9450614a76602087016145f7565b9350604086013592506060860135915060808601356001600160401b03811115614a9f57600080fd5b614aab88828901614a2d565b9150509295509295909350565b60005b83811015614ad3578181015183820152602001614abb565b8381111561172f5750506000910152565b60008151808452614afc816020860160208601614ab8565b601f01601f19169290920160200192915050565b602081526000611d3b6020830184614ae4565b60008060008060008060008060e0898b031215614b3f57600080fd5b8835614b4a8161476f565b9750614b5860208a016145f7565b9650604089013595506060890135945060808901356001600160401b0380821115614b8257600080fd5b614b8e8c838d0161460e565b9096509450849150614ba260a08c01614656565b935060c08b0135915080821115614bb857600080fd5b50614bc58b828c01614a2d565b9150509295985092959890939650565b600060208284031215614be757600080fd5b8135611d3b8161476f565b60008060408385031215614c0557600080fd5b614c0e836145f7565b9150614c1c602084016145f7565b90509250929050565b600080600080600080600080600060e08a8c031215614c4357600080fd5b614c4c8a6145f7565b985060208a0135975060408a0135965060608a01356001600160401b0380821115614c7657600080fd5b614c828d838e0161460e565b9098509650869150614c9660808d01614656565b955060a08c01359150614ca8826147c2565b90935060c08b01359080821115614cbe57600080fd5b50614ccb8c828d0161460e565b915080935050809150509295985092959850929598565b600080600080600060808688031215614cfa57600080fd5b614d03866145f7565b9450614d11602087016145f7565b93506040860135925060608601356001600160401b03811115614d3357600080fd5b614d3f8882890161460e565b969995985093965092949392505050565b600080600060608486031215614d6557600080fd5b6147a4846145f7565b6000806000806000806000806000806101008b8d031215614d8e57600080fd5b614d978b6145f7565b995060208b01356001600160401b0380821115614db357600080fd5b614dbf8e838f0161460e565b909b509950899150614dd360408e01614656565b985060608d0135975060808d01359150614dec8261476f565b90955060a08c0135945060c08c01359080821115614e0957600080fd5b50614e168d828e0161460e565b9150809450508092505060e08b013590509295989b9194979a5092959850565b60008060008060808587031215614e4c57600080fd5b614e55856145f7565b9350614e63602086016145f7565b92506040850135614e738161476f565b9396929550929360600135925050565b600181811c90821680614e9757607f821691505b602082108103614a3f57634e487b7160e01b600052602260045260246000fd5b8183823760009101908152919050565b60208082526026908201527f4c7a4170703a20696e76616c696420736f757263652073656e64696e6720636f6040820152651b9d1c9858dd60d21b606082015260800190565b600060208284031215614f1f57600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b600082821015614f4e57614f4e614f26565b500390565b60008219821115614f6657614f66614f26565b500190565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff84168152604060208201526000612443604083018486614f6b565b6000808335601e19843603018112614fc957600080fd5b8301803591506001600160401b03821115614fe357600080fd5b60200191503681900382131561464f57600080fd5b6000825161500a818460208701614ab8565b9190910192915050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b600061ffff8088168352808716602084015250846040830152608060608301526140c5608083018486614f6b565b61ffff8916815260c06020820152600061508660c08301898b614f6b565b6001600160401b038816604084015286606084015285608084015282810360a08401526150b4818587614f6b565b9b9a5050505050505050505050565b6000602082840312156150d557600080fd5b81516001600160401b038111156150eb57600080fd5b8201601f810184136150fc57600080fd5b805161510a6149a482614925565b81815285602083850101111561511f57600080fd5b612efa826020830160208601614ab8565b61ffff8516815260806020820152600061514d6080830186614ae4565b6001600160401b038516604084015282810360608401526140c58185614ae4565b61ffff861681526001600160a01b038516602082015260a06040820181905260009061519c90830186614ae4565b841515606084015282810360808401526151b68185614ae4565b98975050505050505050565b600080604083850312156151d557600080fd5b505080516020909101519092909150565b61ffff86168152608060208201526000615204608083018688614f6b565b6001600160401b0394909416604083015250606001529392505050565b61ffff8616815260a06020820152600061523e60a0830187614ae4565b6001600160401b0386166040840152828103606084015261525f8186614ae4565b905082810360808401526151b68185614ae4565b634e487b7160e01b600052601260045260246000fd5b60008261529857615298615273565b500490565b6000602082840312156152af57600080fd5b8151611d3b816147c2565b600061010061ffff8b1683528060208401526152d88184018b614ae4565b6001600160401b038a166040850152606084018990526001600160a01b038816608085015260a0840187905283810360c085015290506153188186614ae4565b9150508260e08301529998505050505050505050565b6060815260006153416060830186614ae4565b6001600160401b039490941660208301525060400152919050565b60008261536b5761536b615273565b500690565b61ffff8716815260c06020820152600061538d60c0830188614ae4565b828103604084015261539f8188614ae4565b6001600160a01b0387811660608601528616608085015283810360a085015290506153ca8185614ae4565b9998505050505050505050565b60ff60f81b8760f81b16815285600182015260006001600160401b0360c01b808760c01b166021840152856029840152808560c01b166049840152508251615426816051850160208701614ab8565b91909101605101979650505050505050565b600081600019048311821515161561545257615452614f26565b50029056fea264697066735822122002e85e39cd4c45156c727cd464d515ec143b5814676650286110a986cc477f2264736f6c634300080d0033", + "devdoc": { + "author": "Venus", + "kind": "dev", + "methods": { + "circulatingSupply()": { + "returns": { + "_0": "total circulating supply of the token on the destination chain." + } + }, + "dropFailedMessage(uint16,bytes,uint64)": { + "custom:access": "Only owner", + "custom:event": "Emits DropFailedMessage on clearance of failed message.", + "params": { + "nonce_": "Nonce_ of the transaction", + "srcAddress_": "Address of source followed by current bridge address", + "srcChainId_": "Chain id of source" + } + }, + "estimateSendFee(uint16,bytes32,uint256,bool,bytes)": { + "details": "estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`) _dstChainId - L0 defined chain id to send tokens too _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain _amount - amount of the tokens to transfer _useZro - indicates to use zro to pay L0 fees _adapterParam - flexible bytes array to indicate messaging adapter services in L0" + }, + "isEligibleToSend(address,uint16,uint256)": { + "details": "This external view function assesses whether the specified sender is eligible to transfer the given amount to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.", + "params": { + "amount_": "The quantity of tokens to be transferred.", + "dstChainId_": "Indicates destination chain.", + "from_": "The sender's address initiating the transfer." + }, + "returns": { + "amountInUsd": "The equivalent amount in USD based on the oracle price.", + "eligibleToSend": "A boolean indicating whether the sender is eligible to transfer the tokens.", + "isWhiteListedUser": "A boolean indicating whether the sender is whitelisted.", + "last24HourWindowStart": "The timestamp when the current 24-hour window started.", + "maxDailyLimit": "The maximum daily limit for transactions.", + "maxSingleTransactionLimit": "The maximum limit for a single transaction.", + "transferredInWindow": "The total amount transferred in the current 24-hour window." + } + }, + "owner()": { + "details": "Returns the address of the current owner." + }, + "pause()": { + "custom:access": "Only owner." + }, + "paused()": { + "details": "Returns true if the contract is paused, and false otherwise." + }, + "removeTrustedRemote(uint16)": { + "custom:access": "Only owner.", + "custom:event": "Emits TrustedRemoteRemoved once chain id is removed from trusted remote.", + "params": { + "remoteChainId_": "The chain's id corresponds to setting the trusted remote to empty." + } + }, + "sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))": { + "details": "This internal override function enables the contract to send tokens and invoke calls on the specified destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.", + "params": { + "amount_": "Amount of tokens that will be transferred.", + "callparams_": "Additional parameters, including refund address, ZRO payment address, and adapter params.", + "dstChainId_": "Destination chain id on which tokens will be send.", + "dstGasForCall_": "The amount of gas allocated for the call on the destination chain.", + "from_": "Address from which tokens will be debited.", + "payload_": "Additional data payload for the call on the destination chain.", + "toAddress_": "Address on which tokens will be credited on destination chain." + } + }, + "sendFrom(address,uint16,bytes32,uint256,(address,address,bytes))": { + "details": "send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from` `_from` the owner of token `_dstChainId` the destination chain identifier `_toAddress` can be any size depending on the `dstChainId`. `_amount` the quantity of tokens in wei `_refundAddress` the address LayerZero refunds if too much message fee is sent `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token) `_adapterParams` is a flexible bytes array to indicate messaging adapter services" + }, + "setMaxDailyLimit(uint16,uint256)": { + "custom:access": "Only owner.", + "custom:event": "Emits setMaxDailyLimit with old and new limit associated with chain id.", + "params": { + "chainId_": "Destination chain id.", + "limit_": "Amount in USD(scaled with 18 decimals)." + } + }, + "setMaxDailyReceiveLimit(uint16,uint256)": { + "custom:access": "Only owner.", + "custom:event": "Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.", + "params": { + "chainId_": "The destination chain ID.", + "limit_": "The new maximum daily limit in USD(scaled with 18 decimals)." + } + }, + "setMaxSingleReceiveTransactionLimit(uint16,uint256)": { + "custom:access": "Only owner.", + "custom:event": "Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.", + "params": { + "chainId_": "The destination chain ID.", + "limit_": "The new maximum limit in USD(scaled with 18 decimals)." + } + }, + "setMaxSingleTransactionLimit(uint16,uint256)": { + "custom:access": "Only owner.", + "custom:event": "Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.", + "params": { + "chainId_": "Destination chain id.", + "limit_": "Amount in USD(scaled with 18 decimals)." + } + }, + "setOracle(address)": { + "custom:access": "Only owner.", + "custom:event": "Emits OracleChanged with old and new oracle address.", + "details": "Reverts if the new address is zero.", + "params": { + "oracleAddress_": "The new address of the ResilientOracle contract." + } + }, + "setWhitelist(address,bool)": { + "custom:access": "Only owner.", + "custom:event": "Emits setWhitelist.", + "params": { + "user_": "Address to be add in whitelist.", + "val_": "Boolean to be set (true for user_ address is whitelisted)." + } + }, + "sweepToken(address,address,uint256)": { + "custom:access": "Only Owner", + "custom:error": "Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract", + "custom:event": "Emits SweepToken event", + "params": { + "amount_": "The amount of tokens needs to transfer", + "to_": "The address of the recipient", + "token_": "The address of the ERC-20 token to sweep" + } + }, + "token()": { + "returns": { + "_0": "Address of the inner token of this bridge." + } + }, + "transferOwnership(address)": { + "details": "Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner." + }, + "unpause()": { + "custom:access": "Only owner." + }, + "updateSendAndCallEnabled(bool)": { + "params": { + "enabled_": "Boolean indicating whether the sendAndCall function should be enabled or disabled." + } + } + }, + "title": "XVSProxyOFTDest", + "version": 1 + }, + "userdoc": { + "errors": { + "InsufficientBalance(uint256,uint256)": [ + { + "notice": "Error thrown when this contract balance is less than sweep amount" + } + ], + "ZeroAddressNotAllowed()": [ + { + "notice": "Thrown if the supplied address is a zero address where it is not allowed" + } + ] + }, + "events": { + "DropFailedMessage(uint16,bytes,uint64)": { + "notice": "Emits when stored message dropped without successful retrying." + }, + "InnerTokenAdded(address)": { + "notice": "Event emitted when inner token set successfully." + }, + "OracleChanged(address,address)": { + "notice": "Event emitted when oracle is modified." + }, + "SetMaxDailyLimit(uint16,uint256,uint256)": { + "notice": "Emitted when the maximum daily limit of transactions from local chain is modified." + }, + "SetMaxDailyReceiveLimit(uint16,uint256,uint256)": { + "notice": "Emitted when the maximum daily limit for receiving transactions from remote chain is modified." + }, + "SetMaxSingleReceiveTransactionLimit(uint16,uint256,uint256)": { + "notice": "Emitted when the maximum limit for a single receive transaction from remote chain is modified." + }, + "SetMaxSingleTransactionLimit(uint16,uint256,uint256)": { + "notice": "Emitted when the maximum limit for a single transaction from local chain is modified." + }, + "SetWhitelist(address,bool)": { + "notice": "Emitted when address is added to whitelist." + }, + "SweepToken(address,address,uint256)": { + "notice": "Emitted on sweep token success" + }, + "TrustedRemoteRemoved(uint16)": { + "notice": "Event emitted when trusted remote sets to empty." + }, + "UpdateSendAndCallEnabled(bool)": { + "notice": "Event emitted when SendAndCallEnabled updated successfully." + } + }, + "kind": "user", + "methods": { + "chainIdToLast24HourReceiveWindowStart(uint16)": { + "notice": "Timestamp when the last 24-hour window started from remote chain." + }, + "chainIdToLast24HourReceived(uint16)": { + "notice": "Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain." + }, + "chainIdToLast24HourTransferred(uint16)": { + "notice": "Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain." + }, + "chainIdToLast24HourWindowStart(uint16)": { + "notice": "Timestamp when the last 24-hour window started from local chain." + }, + "chainIdToMaxDailyLimit(uint16)": { + "notice": "Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain." + }, + "chainIdToMaxDailyReceiveLimit(uint16)": { + "notice": "Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain." + }, + "chainIdToMaxSingleReceiveTransactionLimit(uint16)": { + "notice": "Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain." + }, + "chainIdToMaxSingleTransactionLimit(uint16)": { + "notice": "Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain." + }, + "circulatingSupply()": { + "notice": "Returns the total circulating supply of the token on the destination chain i.e (total supply)." + }, + "dropFailedMessage(uint16,bytes,uint64)": { + "notice": "Clear failed messages from the storage." + }, + "isEligibleToSend(address,uint16,uint256)": { + "notice": "Checks the eligibility of a sender to initiate a cross-chain token transfer." + }, + "oracle()": { + "notice": "The address of ResilientOracle contract wrapped in its interface." + }, + "pause()": { + "notice": "Triggers stopped state of the bridge." + }, + "removeTrustedRemote(uint16)": { + "notice": "Remove trusted remote from storage." + }, + "renounceOwnership()": { + "notice": "Empty implementation of renounce ownership to avoid any mishappening." + }, + "sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))": { + "notice": "Initiates a cross-chain token transfer and triggers a call on the destination chain." + }, + "setMaxDailyLimit(uint16,uint256)": { + "notice": "Sets the limit of daily (24 Hour) transactions amount." + }, + "setMaxDailyReceiveLimit(uint16,uint256)": { + "notice": "Sets the maximum daily limit for receiving transactions." + }, + "setMaxSingleReceiveTransactionLimit(uint16,uint256)": { + "notice": "Sets the maximum limit for a single receive transaction." + }, + "setMaxSingleTransactionLimit(uint16,uint256)": { + "notice": "Sets the limit of single transaction amount." + }, + "setOracle(address)": { + "notice": "Set the address of the ResilientOracle contract." + }, + "setWhitelist(address,bool)": { + "notice": "Sets the whitelist address to skip checks on transaction limit." + }, + "sweepToken(address,address,uint256)": { + "notice": "A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user" + }, + "token()": { + "notice": "Return's the address of the inner token of this bridge." + }, + "unpause()": { + "notice": "Triggers resume state of the bridge." + }, + "updateSendAndCallEnabled(bool)": { + "notice": "It enables or disables sendAndCall functionality for the bridge." + }, + "whitelist(address)": { + "notice": "Address on which cap check and bound limit is not applicable." + } + }, + "notice": "XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT, and focuses on managing token transfers to the destination chain. It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.", + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 5506, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "_paused", + "offset": 0, + "slot": "0", + "type": "t_bool" + }, + { + "astId": 5383, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "_owner", + "offset": 1, + "slot": "0", + "type": "t_address" + }, + { + "astId": 455, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "trustedRemoteLookup", + "offset": 0, + "slot": "1", + "type": "t_mapping(t_uint16,t_bytes_storage)" + }, + { + "astId": 461, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "minDstGasLookup", + "offset": 0, + "slot": "2", + "type": "t_mapping(t_uint16,t_mapping(t_uint16,t_uint256))" + }, + { + "astId": 465, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "payloadSizeLimitLookup", + "offset": 0, + "slot": "3", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 467, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "precrime", + "offset": 0, + "slot": "4", + "type": "t_address" + }, + { + "astId": 997, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "failedMessages", + "offset": 0, + "slot": "5", + "type": "t_mapping(t_uint16,t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bytes32)))" + }, + { + "astId": 3161, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "creditedPackets", + "offset": 0, + "slot": "6", + "type": "t_mapping(t_uint16,t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bool)))" + }, + { + "astId": 9369, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "sendAndCallEnabled", + "offset": 0, + "slot": "7", + "type": "t_bool" + }, + { + "astId": 9373, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "oracle", + "offset": 1, + "slot": "7", + "type": "t_contract(ResilientOracleInterface)8694" + }, + { + "astId": 9378, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToMaxSingleTransactionLimit", + "offset": 0, + "slot": "8", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9383, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToMaxDailyLimit", + "offset": 0, + "slot": "9", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9388, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToLast24HourTransferred", + "offset": 0, + "slot": "10", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9393, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToLast24HourWindowStart", + "offset": 0, + "slot": "11", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9398, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToMaxSingleReceiveTransactionLimit", + "offset": 0, + "slot": "12", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9403, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToMaxDailyReceiveLimit", + "offset": 0, + "slot": "13", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9408, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToLast24HourReceived", + "offset": 0, + "slot": "14", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9413, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "chainIdToLast24HourReceiveWindowStart", + "offset": 0, + "slot": "15", + "type": "t_mapping(t_uint16,t_uint256)" + }, + { + "astId": 9418, + "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", + "label": "whitelist", + "offset": 0, + "slot": "16", + "type": "t_mapping(t_address,t_bool)" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + }, + "t_bool": { + "encoding": "inplace", + "label": "bool", + "numberOfBytes": "1" + }, + "t_bytes32": { + "encoding": "inplace", + "label": "bytes32", + "numberOfBytes": "32" + }, + "t_bytes_memory_ptr": { + "encoding": "bytes", + "label": "bytes", + "numberOfBytes": "32" + }, + "t_bytes_storage": { + "encoding": "bytes", + "label": "bytes", + "numberOfBytes": "32" + }, + "t_contract(ResilientOracleInterface)8694": { + "encoding": "inplace", + "label": "contract ResilientOracleInterface", + "numberOfBytes": "20" + }, + "t_mapping(t_address,t_bool)": { + "encoding": "mapping", + "key": "t_address", + "label": "mapping(address => bool)", + "numberOfBytes": "32", + "value": "t_bool" + }, + "t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bool))": { + "encoding": "mapping", + "key": "t_bytes_memory_ptr", + "label": "mapping(bytes => mapping(uint64 => bool))", + "numberOfBytes": "32", + "value": "t_mapping(t_uint64,t_bool)" + }, + "t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bytes32))": { + "encoding": "mapping", + "key": "t_bytes_memory_ptr", + "label": "mapping(bytes => mapping(uint64 => bytes32))", + "numberOfBytes": "32", + "value": "t_mapping(t_uint64,t_bytes32)" + }, + "t_mapping(t_uint16,t_bytes_storage)": { + "encoding": "mapping", + "key": "t_uint16", + "label": "mapping(uint16 => bytes)", + "numberOfBytes": "32", + "value": "t_bytes_storage" + }, + "t_mapping(t_uint16,t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bool)))": { + "encoding": "mapping", + "key": "t_uint16", + "label": "mapping(uint16 => mapping(bytes => mapping(uint64 => bool)))", + "numberOfBytes": "32", + "value": "t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bool))" + }, + "t_mapping(t_uint16,t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bytes32)))": { + "encoding": "mapping", + "key": "t_uint16", + "label": "mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32)))", + "numberOfBytes": "32", + "value": "t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bytes32))" + }, + "t_mapping(t_uint16,t_mapping(t_uint16,t_uint256))": { + "encoding": "mapping", + "key": "t_uint16", + "label": "mapping(uint16 => mapping(uint16 => uint256))", + "numberOfBytes": "32", + "value": "t_mapping(t_uint16,t_uint256)" + }, + "t_mapping(t_uint16,t_uint256)": { + "encoding": "mapping", + "key": "t_uint16", + "label": "mapping(uint16 => uint256)", + "numberOfBytes": "32", + "value": "t_uint256" + }, + "t_mapping(t_uint64,t_bool)": { + "encoding": "mapping", + "key": "t_uint64", + "label": "mapping(uint64 => bool)", + "numberOfBytes": "32", + "value": "t_bool" + }, + "t_mapping(t_uint64,t_bytes32)": { + "encoding": "mapping", + "key": "t_uint64", + "label": "mapping(uint64 => bytes32)", + "numberOfBytes": "32", + "value": "t_bytes32" + }, + "t_uint16": { + "encoding": "inplace", + "label": "uint16", + "numberOfBytes": "2" + }, + "t_uint256": { + "encoding": "inplace", + "label": "uint256", + "numberOfBytes": "32" + }, + "t_uint64": { + "encoding": "inplace", + "label": "uint64", + "numberOfBytes": "8" + } + } + } +} diff --git a/deployments/arbitrumsepolia/solcInputs/0e89febeebc7444140de8e67c9067d2c.json b/deployments/arbitrumsepolia/solcInputs/0e89febeebc7444140de8e67c9067d2c.json new file mode 100644 index 0000000..557e5cb --- /dev/null +++ b/deployments/arbitrumsepolia/solcInputs/0e89febeebc7444140de8e67c9067d2c.json @@ -0,0 +1,78 @@ +{ + "language": "Solidity", + "sources": { + "solc_0.8/openzeppelin/access/Ownable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n constructor (address initialOwner) {\n _transferOwnership(initialOwner);\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n _;\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions anymore. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby removing any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n}\n" + }, + "solc_0.8/openzeppelin/utils/Context.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/transparent/ProxyAdmin.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/ProxyAdmin.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./TransparentUpgradeableProxy.sol\";\nimport \"../../access/Ownable.sol\";\n\n/**\n * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an\n * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.\n */\ncontract ProxyAdmin is Ownable {\n\n constructor (address initialOwner) Ownable(initialOwner) {}\n\n /**\n * @dev Returns the current implementation of `proxy`.\n *\n * Requirements:\n *\n * - This contract must be the admin of `proxy`.\n */\n function getProxyImplementation(TransparentUpgradeableProxy proxy) public view virtual returns (address) {\n // We need to manually run the static call since the getter cannot be flagged as view\n // bytes4(keccak256(\"implementation()\")) == 0x5c60da1b\n (bool success, bytes memory returndata) = address(proxy).staticcall(hex\"5c60da1b\");\n require(success);\n return abi.decode(returndata, (address));\n }\n\n /**\n * @dev Returns the current admin of `proxy`.\n *\n * Requirements:\n *\n * - This contract must be the admin of `proxy`.\n */\n function getProxyAdmin(TransparentUpgradeableProxy proxy) public view virtual returns (address) {\n // We need to manually run the static call since the getter cannot be flagged as view\n // bytes4(keccak256(\"admin()\")) == 0xf851a440\n (bool success, bytes memory returndata) = address(proxy).staticcall(hex\"f851a440\");\n require(success);\n return abi.decode(returndata, (address));\n }\n\n /**\n * @dev Changes the admin of `proxy` to `newAdmin`.\n *\n * Requirements:\n *\n * - This contract must be the current admin of `proxy`.\n */\n function changeProxyAdmin(TransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {\n proxy.changeAdmin(newAdmin);\n }\n\n /**\n * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.\n *\n * Requirements:\n *\n * - This contract must be the admin of `proxy`.\n */\n function upgrade(TransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {\n proxy.upgradeTo(implementation);\n }\n\n /**\n * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See\n * {TransparentUpgradeableProxy-upgradeToAndCall}.\n *\n * Requirements:\n *\n * - This contract must be the admin of `proxy`.\n */\n function upgradeAndCall(\n TransparentUpgradeableProxy proxy,\n address implementation,\n bytes memory data\n ) public payable virtual onlyOwner {\n proxy.upgradeToAndCall{value: msg.value}(implementation, data);\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/transparent/TransparentUpgradeableProxy.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../ERC1967/ERC1967Proxy.sol\";\n\n/**\n * @dev This contract implements a proxy that is upgradeable by an admin.\n *\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\n * clashing], which can potentially be used in an attack, this contract uses the\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\n * things that go hand in hand:\n *\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\n * that call matches one of the admin functions exposed by the proxy itself.\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\n * \"admin cannot fallback to proxy target\".\n *\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\n * to sudden errors when trying to call a function from the proxy implementation.\n *\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\n */\ncontract TransparentUpgradeableProxy is ERC1967Proxy {\n /**\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\n */\n constructor(\n address _logic,\n address admin_,\n bytes memory _data\n ) payable ERC1967Proxy(_logic, _data) {\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\"eip1967.proxy.admin\")) - 1));\n _changeAdmin(admin_);\n }\n\n /**\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\n */\n modifier ifAdmin() {\n if (msg.sender == _getAdmin()) {\n _;\n } else {\n _fallback();\n }\n }\n\n /**\n * @dev Returns the current admin.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\n *\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\n */\n function admin() external ifAdmin returns (address admin_) {\n admin_ = _getAdmin();\n }\n\n /**\n * @dev Returns the current implementation.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\n *\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\n */\n function implementation() external ifAdmin returns (address implementation_) {\n implementation_ = _implementation();\n }\n\n /**\n * @dev Changes the admin of the proxy.\n *\n * Emits an {AdminChanged} event.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.\n */\n function changeAdmin(address newAdmin) external virtual ifAdmin {\n _changeAdmin(newAdmin);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\n */\n function upgradeTo(address newImplementation) external ifAdmin {\n _upgradeToAndCall(newImplementation, bytes(\"\"), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\n * proxied contract.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\n */\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\n _upgradeToAndCall(newImplementation, data, true);\n }\n\n /**\n * @dev Returns the current admin.\n */\n function _admin() internal view virtual returns (address) {\n return _getAdmin();\n }\n\n /**\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\n */\n function _beforeFallback() internal virtual override {\n require(msg.sender != _getAdmin(), \"TransparentUpgradeableProxy: admin cannot fallback to proxy target\");\n super._beforeFallback();\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../Proxy.sol\";\nimport \"./ERC1967Upgrade.sol\";\n\n/**\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\n * implementation address that can be changed. This address is stored in storage in the location specified by\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\n * implementation behind the proxy.\n */\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\n /**\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\n *\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\n */\n constructor(address _logic, bytes memory _data) payable {\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\"eip1967.proxy.implementation\")) - 1));\n _upgradeToAndCall(_logic, _data, false);\n }\n\n /**\n * @dev Returns the current implementation address.\n */\n function _implementation() internal view virtual override returns (address impl) {\n return ERC1967Upgrade._getImplementation();\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/Proxy.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\n * be specified by overriding the virtual {_implementation} function.\n *\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\n * different contract through the {_delegate} function.\n *\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\n */\nabstract contract Proxy {\n /**\n * @dev Delegates the current call to `implementation`.\n *\n * This function does not return to its internal call site, it will return directly to the external caller.\n */\n function _delegate(address implementation) internal virtual {\n assembly {\n // Copy msg.data. We take full control of memory in this inline assembly\n // block because it will not return to Solidity code. We overwrite the\n // Solidity scratch pad at memory position 0.\n calldatacopy(0, 0, calldatasize())\n\n // Call the implementation.\n // out and outsize are 0 because we don't know the size yet.\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\n\n // Copy the returned data.\n returndatacopy(0, 0, returndatasize())\n\n switch result\n // delegatecall returns 0 on error.\n case 0 {\n revert(0, returndatasize())\n }\n default {\n return(0, returndatasize())\n }\n }\n }\n\n /**\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\n * and {_fallback} should delegate.\n */\n function _implementation() internal view virtual returns (address);\n\n /**\n * @dev Delegates the current call to the address returned by `_implementation()`.\n *\n * This function does not return to its internall call site, it will return directly to the external caller.\n */\n function _fallback() internal virtual {\n _beforeFallback();\n _delegate(_implementation());\n }\n\n /**\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\n * function in the contract matches the call data.\n */\n fallback() external payable virtual {\n _fallback();\n }\n\n /**\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\n * is empty.\n */\n receive() external payable virtual {\n _fallback();\n }\n\n /**\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\n * call, or as part of the Solidity `fallback` or `receive` functions.\n *\n * If overriden should call `super._beforeFallback()`.\n */\n function _beforeFallback() internal virtual {}\n}\n" + }, + "solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../beacon/IBeacon.sol\";\nimport \"../../interfaces/draft-IERC1822.sol\";\nimport \"../../utils/Address.sol\";\nimport \"../../utils/StorageSlot.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n *\n * _Available since v4.1._\n *\n * @custom:oz-upgrades-unsafe-allow delegatecall\n */\nabstract contract ERC1967Upgrade {\n // This is the keccak-256 hash of \"eip1967.proxy.rollback\" subtracted by 1\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n /**\n * @dev Emitted when the implementation is upgraded.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Returns the current implementation address.\n */\n function _getImplementation() internal view returns (address) {\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 implementation slot.\n */\n function _setImplementation(address newImplementation) private {\n require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n }\n\n /**\n * @dev Perform implementation upgrade\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Perform implementation upgrade with additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCall(\n address newImplementation,\n bytes memory data,\n bool forceCall\n ) internal {\n _upgradeTo(newImplementation);\n if (data.length > 0 || forceCall) {\n Address.functionDelegateCall(newImplementation, data);\n }\n }\n\n /**\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCallUUPS(\n address newImplementation,\n bytes memory data,\n bool forceCall\n ) internal {\n // Upgrades from old implementations will perform a rollback test. This test requires the new\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\n // this special case will break upgrade paths from old UUPS implementation to new ones.\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\n _setImplementation(newImplementation);\n } else {\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n require(slot == _IMPLEMENTATION_SLOT, \"ERC1967Upgrade: unsupported proxiableUUID\");\n } catch {\n revert(\"ERC1967Upgrade: new implementation is not UUPS\");\n }\n _upgradeToAndCall(newImplementation, data, forceCall);\n }\n }\n\n /**\n * @dev Storage slot with the admin of the contract.\n * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n /**\n * @dev Emitted when the admin account has changed.\n */\n event AdminChanged(address previousAdmin, address newAdmin);\n\n /**\n * @dev Returns the current admin.\n */\n function _getAdmin() internal view virtual returns (address) {\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 admin slot.\n */\n function _setAdmin(address newAdmin) private {\n require(newAdmin != address(0), \"ERC1967: new admin is the zero address\");\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\n }\n\n /**\n * @dev Changes the admin of the proxy.\n *\n * Emits an {AdminChanged} event.\n */\n function _changeAdmin(address newAdmin) internal {\n emit AdminChanged(_getAdmin(), newAdmin);\n _setAdmin(newAdmin);\n }\n\n /**\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\n */\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n /**\n * @dev Emitted when the beacon is upgraded.\n */\n event BeaconUpgraded(address indexed beacon);\n\n /**\n * @dev Returns the current beacon.\n */\n function _getBeacon() internal view returns (address) {\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\n }\n\n /**\n * @dev Stores a new beacon in the EIP1967 beacon slot.\n */\n function _setBeacon(address newBeacon) private {\n require(Address.isContract(newBeacon), \"ERC1967: new beacon is not a contract\");\n require(Address.isContract(IBeacon(newBeacon).implementation()), \"ERC1967: beacon implementation is not a contract\");\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\n }\n\n /**\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\n *\n * Emits a {BeaconUpgraded} event.\n */\n function _upgradeBeaconToAndCall(\n address newBeacon,\n bytes memory data,\n bool forceCall\n ) internal {\n _setBeacon(newBeacon);\n emit BeaconUpgraded(newBeacon);\n if (data.length > 0 || forceCall) {\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\n }\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeacon {\n /**\n * @dev Must return an address that can be used as a delegate call target.\n *\n * {BeaconProxy} will check that this address is a contract.\n */\n function implementation() external view returns (address);\n}\n" + }, + "solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822Proxiable {\n /**\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n * address.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy.\n */\n function proxiableUUID() external view returns (bytes32);\n}\n" + }, + "solc_0.8/openzeppelin/utils/Address.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCall(target, data, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n require(isContract(target), \"Address: call to non-contract\");\n\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n require(isContract(target), \"Address: static call to non-contract\");\n\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(isContract(target), \"Address: delegate call to non-contract\");\n\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n }\n}\n" + }, + "solc_0.8/openzeppelin/utils/StorageSlot.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```\n * contract ERC1967 {\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n * function _getImplementation() internal view returns (address) {\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n * }\n *\n * function _setImplementation(address newImplementation) internal {\n * require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n * }\n * }\n * ```\n *\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\n */\nlibrary StorageSlot {\n struct AddressSlot {\n address value;\n }\n\n struct BooleanSlot {\n bool value;\n }\n\n struct Bytes32Slot {\n bytes32 value;\n }\n\n struct Uint256Slot {\n uint256 value;\n }\n\n /**\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n */\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n */\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n */\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n */\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n assembly {\n r.slot := slot\n }\n }\n}\n" + }, + "solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\";\n\n/**\n * @dev This contract implements a proxy that is upgradeable by an admin.\n *\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\n * clashing], which can potentially be used in an attack, this contract uses the\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\n * things that go hand in hand:\n *\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\n * that call matches one of the admin functions exposed by the proxy itself.\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\n * \"admin cannot fallback to proxy target\".\n *\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\n * to sudden errors when trying to call a function from the proxy implementation.\n *\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\n */\ncontract OptimizedTransparentUpgradeableProxy is ERC1967Proxy {\n address internal immutable _ADMIN;\n\n /**\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\n */\n constructor(\n address _logic,\n address admin_,\n bytes memory _data\n ) payable ERC1967Proxy(_logic, _data) {\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\"eip1967.proxy.admin\")) - 1));\n _ADMIN = admin_;\n\n // still store it to work with EIP-1967\n bytes32 slot = _ADMIN_SLOT;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(slot, admin_)\n }\n emit AdminChanged(address(0), admin_);\n }\n\n /**\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\n */\n modifier ifAdmin() {\n if (msg.sender == _getAdmin()) {\n _;\n } else {\n _fallback();\n }\n }\n\n /**\n * @dev Returns the current admin.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\n *\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\n */\n function admin() external ifAdmin returns (address admin_) {\n admin_ = _getAdmin();\n }\n\n /**\n * @dev Returns the current implementation.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\n *\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\n */\n function implementation() external ifAdmin returns (address implementation_) {\n implementation_ = _implementation();\n }\n\n /**\n * @dev Upgrade the implementation of the proxy.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\n */\n function upgradeTo(address newImplementation) external ifAdmin {\n _upgradeToAndCall(newImplementation, bytes(\"\"), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\n * proxied contract.\n *\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\n */\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\n _upgradeToAndCall(newImplementation, data, true);\n }\n\n /**\n * @dev Returns the current admin.\n */\n function _admin() internal view virtual returns (address) {\n return _getAdmin();\n }\n\n /**\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\n */\n function _beforeFallback() internal virtual override {\n require(msg.sender != _getAdmin(), \"TransparentUpgradeableProxy: admin cannot fallback to proxy target\");\n super._beforeFallback();\n }\n\n function _getAdmin() internal view virtual override returns (address) {\n return _ADMIN;\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/utils/UUPSUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../interfaces/draft-IERC1822.sol\";\nimport \"../ERC1967/ERC1967Upgrade.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n *\n * _Available since v4.1._\n */\nabstract contract UUPSUpgradeable is IERC1822Proxiable, ERC1967Upgrade {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment\n address private immutable __self = address(this);\n\n /**\n * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n * fail.\n */\n modifier onlyProxy() {\n require(address(this) != __self, \"Function must be called through delegatecall\");\n require(_getImplementation() == __self, \"Function must be called through active proxy\");\n _;\n }\n\n /**\n * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n * callable on the implementing contract but not through proxies.\n */\n modifier notDelegated() {\n require(address(this) == __self, \"UUPSUpgradeable: must not be called through delegatecall\");\n _;\n }\n\n /**\n * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n * implementation. It is used to validate that the this implementation remains valid after an upgrade.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n */\n function proxiableUUID() external view virtual override notDelegated returns (bytes32) {\n return _IMPLEMENTATION_SLOT;\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n */\n function upgradeTo(address newImplementation) external virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n * encoded in `data`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n */\n function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, data, true);\n }\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n *\n * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n *\n * ```solidity\n * function _authorizeUpgrade(address) internal override onlyOwner {}\n * ```\n */\n function _authorizeUpgrade(address newImplementation) internal virtual;\n}\n" + }, + "solc_0.8/openzeppelin/proxy/utils/Initializable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../utils/Address.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To initialize the implementation contract, you can either invoke the\n * initializer manually, or you can include a constructor to automatically mark it as initialized when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() initializer {}\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n */\n bool private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Modifier to protect an initializer function from being invoked twice.\n */\n modifier initializer() {\n // If the contract is initializing we ignore whether _initialized is set in order to support multiple\n // inheritance patterns, but we only do this in the context of a constructor, because in other contexts the\n // contract may have been reentered.\n require(_initializing ? _isConstructor() : !_initialized, \"Initializable: contract is already initialized\");\n\n bool isTopLevelCall = !_initializing;\n if (isTopLevelCall) {\n _initializing = true;\n _initialized = true;\n }\n\n _;\n\n if (isTopLevelCall) {\n _initializing = false;\n }\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} modifier, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n function _isConstructor() private view returns (bool) {\n return !Address.isContract(address(this));\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/beacon/UpgradeableBeacon.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/UpgradeableBeacon.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IBeacon.sol\";\nimport \"../../access/Ownable.sol\";\nimport \"../../utils/Address.sol\";\n\n/**\n * @dev This contract is used in conjunction with one or more instances of {BeaconProxy} to determine their\n * implementation contract, which is where they will delegate all function calls.\n *\n * An owner is able to change the implementation the beacon points to, thus upgrading the proxies that use this beacon.\n */\ncontract UpgradeableBeacon is IBeacon, Ownable {\n address private _implementation;\n\n /**\n * @dev Emitted when the implementation returned by the beacon is changed.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Sets the address of the initial implementation, and the deployer account as the owner who can upgrade the\n * beacon.\n */\n\n constructor(address implementation_, address initialOwner) Ownable(initialOwner) {\n _setImplementation(implementation_);\n }\n\n /**\n * @dev Returns the current implementation address.\n */\n function implementation() public view virtual override returns (address) {\n return _implementation;\n }\n\n /**\n * @dev Upgrades the beacon to a new implementation.\n *\n * Emits an {Upgraded} event.\n *\n * Requirements:\n *\n * - msg.sender must be the owner of the contract.\n * - `newImplementation` must be a contract.\n */\n function upgradeTo(address newImplementation) public virtual onlyOwner {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Sets the implementation contract address for this beacon\n *\n * Requirements:\n *\n * - `newImplementation` must be a contract.\n */\n function _setImplementation(address newImplementation) private {\n require(Address.isContract(newImplementation), \"UpgradeableBeacon: implementation is not a contract\");\n _implementation = newImplementation;\n }\n}\n" + }, + "solc_0.8/openzeppelin/proxy/beacon/BeaconProxy.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/BeaconProxy.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IBeacon.sol\";\nimport \"../Proxy.sol\";\nimport \"../ERC1967/ERC1967Upgrade.sol\";\n\n/**\n * @dev This contract implements a proxy that gets the implementation address for each call from a {UpgradeableBeacon}.\n *\n * The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't\n * conflict with the storage layout of the implementation behind the proxy.\n *\n * _Available since v3.4._\n */\ncontract BeaconProxy is Proxy, ERC1967Upgrade {\n /**\n * @dev Initializes the proxy with `beacon`.\n *\n * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This\n * will typically be an encoded function call, and allows initializating the storage of the proxy like a Solidity\n * constructor.\n *\n * Requirements:\n *\n * - `beacon` must be a contract with the interface {IBeacon}.\n */\n constructor(address beacon, bytes memory data) payable {\n assert(_BEACON_SLOT == bytes32(uint256(keccak256(\"eip1967.proxy.beacon\")) - 1));\n _upgradeBeaconToAndCall(beacon, data, false);\n }\n\n /**\n * @dev Returns the current beacon address.\n */\n function _beacon() internal view virtual returns (address) {\n return _getBeacon();\n }\n\n /**\n * @dev Returns the current implementation address of the associated beacon.\n */\n function _implementation() internal view virtual override returns (address) {\n return IBeacon(_getBeacon()).implementation();\n }\n\n /**\n * @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.\n *\n * If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.\n *\n * Requirements:\n *\n * - `beacon` must be a contract.\n * - The implementation returned by `beacon` must be a contract.\n */\n function _setBeacon(address beacon, bytes memory data) internal virtual {\n _upgradeBeaconToAndCall(beacon, data, false);\n }\n}\n" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 999999 + }, + "outputSelection": { + "*": { + "*": [ + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "storageLayout", + "evm.gasEstimates" + ], + "": ["ast"] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} diff --git a/deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json b/deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json new file mode 100644 index 0000000..556e3c9 --- /dev/null +++ b/deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json @@ -0,0 +1,186 @@ +{ + "language": "Solidity", + "sources": { + "@layerzerolabs/solidity-examples/contracts/libraries/BytesLib.sol": { + "content": "// SPDX-License-Identifier: Unlicense\n/*\n * @title Solidity Bytes Arrays Utils\n * @author Gonçalo Sá \n *\n * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.\n * The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.\n */\npragma solidity >=0.8.0 <0.9.0;\n\nlibrary BytesLib {\n function concat(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bytes memory) {\n bytes memory tempBytes;\n\n assembly {\n // Get a location of some free memory and store it in tempBytes as\n // Solidity does for memory variables.\n tempBytes := mload(0x40)\n\n // Store the length of the first bytes array at the beginning of\n // the memory for tempBytes.\n let length := mload(_preBytes)\n mstore(tempBytes, length)\n\n // Maintain a memory counter for the current write location in the\n // temp bytes array by adding the 32 bytes for the array length to\n // the starting location.\n let mc := add(tempBytes, 0x20)\n // Stop copying when the memory counter reaches the length of the\n // first bytes array.\n let end := add(mc, length)\n\n for {\n // Initialize a copy counter to the start of the _preBytes data,\n // 32 bytes into its memory.\n let cc := add(_preBytes, 0x20)\n } lt(mc, end) {\n // Increase both counters by 32 bytes each iteration.\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n // Write the _preBytes data into the tempBytes memory 32 bytes\n // at a time.\n mstore(mc, mload(cc))\n }\n\n // Add the length of _postBytes to the current length of tempBytes\n // and store it as the new length in the first 32 bytes of the\n // tempBytes memory.\n length := mload(_postBytes)\n mstore(tempBytes, add(length, mload(tempBytes)))\n\n // Move the memory counter back from a multiple of 0x20 to the\n // actual end of the _preBytes data.\n mc := end\n // Stop copying when the memory counter reaches the new combined\n // length of the arrays.\n end := add(mc, length)\n\n for {\n let cc := add(_postBytes, 0x20)\n } lt(mc, end) {\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n mstore(mc, mload(cc))\n }\n\n // Update the free-memory pointer by padding our last write location\n // to 32 bytes: add 31 bytes to the end of tempBytes to move to the\n // next 32 byte block, then round down to the nearest multiple of\n // 32. If the sum of the length of the two arrays is zero then add\n // one before rounding down to leave a blank 32 bytes (the length block with 0).\n mstore(\n 0x40,\n and(\n add(add(end, iszero(add(length, mload(_preBytes)))), 31),\n not(31) // Round down to the nearest 32 bytes.\n )\n )\n }\n\n return tempBytes;\n }\n\n function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {\n assembly {\n // Read the first 32 bytes of _preBytes storage, which is the length\n // of the array. (We don't need to use the offset into the slot\n // because arrays use the entire slot.)\n let fslot := sload(_preBytes.slot)\n // Arrays of 31 bytes or less have an even value in their slot,\n // while longer arrays have an odd value. The actual length is\n // the slot divided by two for odd values, and the lowest order\n // byte divided by two for even values.\n // If the slot is even, bitwise and the slot with 255 and divide by\n // two to get the length. If the slot is odd, bitwise and the slot\n // with -1 and divide by two.\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\n let mlength := mload(_postBytes)\n let newlength := add(slength, mlength)\n // slength can contain both the length and contents of the array\n // if length < 32 bytes so let's prepare for that\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\n switch add(lt(slength, 32), lt(newlength, 32))\n case 2 {\n // Since the new array still fits in the slot, we just need to\n // update the contents of the slot.\n // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length\n sstore(\n _preBytes.slot,\n // all the modifications to the slot are inside this\n // next block\n add(\n // we can just add to the slot contents because the\n // bytes we want to change are the LSBs\n fslot,\n add(\n mul(\n div(\n // load the bytes from memory\n mload(add(_postBytes, 0x20)),\n // zero all bytes to the right\n exp(0x100, sub(32, mlength))\n ),\n // and now shift left the number of bytes to\n // leave space for the length in the slot\n exp(0x100, sub(32, newlength))\n ),\n // increase length by the double of the memory\n // bytes length\n mul(mlength, 2)\n )\n )\n )\n }\n case 1 {\n // The stored value fits in the slot, but the combined value\n // will exceed it.\n // get the keccak hash to get the contents of the array\n mstore(0x0, _preBytes.slot)\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\n\n // save new length\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\n\n // The contents of the _postBytes array start 32 bytes into\n // the structure. Our first read should obtain the `submod`\n // bytes that can fit into the unused space in the last word\n // of the stored array. To get this, we read 32 bytes starting\n // from `submod`, so the data we read overlaps with the array\n // contents by `submod` bytes. Masking the lowest-order\n // `submod` bytes allows us to add that value directly to the\n // stored value.\n\n let submod := sub(32, slength)\n let mc := add(_postBytes, submod)\n let end := add(_postBytes, mlength)\n let mask := sub(exp(0x100, submod), 1)\n\n sstore(sc, add(and(fslot, 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00), and(mload(mc), mask)))\n\n for {\n mc := add(mc, 0x20)\n sc := add(sc, 1)\n } lt(mc, end) {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } {\n sstore(sc, mload(mc))\n }\n\n mask := exp(0x100, sub(mc, end))\n\n sstore(sc, mul(div(mload(mc), mask), mask))\n }\n default {\n // get the keccak hash to get the contents of the array\n mstore(0x0, _preBytes.slot)\n // Start copying to the last used word of the stored array.\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\n\n // save new length\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\n\n // Copy over the first `submod` bytes of the new data as in\n // case 1 above.\n let slengthmod := mod(slength, 32)\n let mlengthmod := mod(mlength, 32)\n let submod := sub(32, slengthmod)\n let mc := add(_postBytes, submod)\n let end := add(_postBytes, mlength)\n let mask := sub(exp(0x100, submod), 1)\n\n sstore(sc, add(sload(sc), and(mload(mc), mask)))\n\n for {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } lt(mc, end) {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } {\n sstore(sc, mload(mc))\n }\n\n mask := exp(0x100, sub(mc, end))\n\n sstore(sc, mul(div(mload(mc), mask), mask))\n }\n }\n }\n\n function slice(\n bytes memory _bytes,\n uint _start,\n uint _length\n ) internal pure returns (bytes memory) {\n require(_length + 31 >= _length, \"slice_overflow\");\n require(_bytes.length >= _start + _length, \"slice_outOfBounds\");\n\n bytes memory tempBytes;\n\n assembly {\n switch iszero(_length)\n case 0 {\n // Get a location of some free memory and store it in tempBytes as\n // Solidity does for memory variables.\n tempBytes := mload(0x40)\n\n // The first word of the slice result is potentially a partial\n // word read from the original array. To read it, we calculate\n // the length of that partial word and start copying that many\n // bytes into the array. The first word we copy will start with\n // data we don't care about, but the last `lengthmod` bytes will\n // land at the beginning of the contents of the new array. When\n // we're done copying, we overwrite the full first word with\n // the actual length of the slice.\n let lengthmod := and(_length, 31)\n\n // The multiplication in the next line is necessary\n // because when slicing multiples of 32 bytes (lengthmod == 0)\n // the following copy loop was copying the origin's length\n // and then ending prematurely not copying everything it should.\n let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))\n let end := add(mc, _length)\n\n for {\n // The multiplication in the next line has the same exact purpose\n // as the one above.\n let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)\n } lt(mc, end) {\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n mstore(mc, mload(cc))\n }\n\n mstore(tempBytes, _length)\n\n //update free-memory pointer\n //allocating the array padded to 32 bytes like the compiler does now\n mstore(0x40, and(add(mc, 31), not(31)))\n }\n //if we want a zero-length slice let's just return a zero-length array\n default {\n tempBytes := mload(0x40)\n //zero out the 32 bytes slice we are about to return\n //we need to do it because Solidity does not garbage collect\n mstore(tempBytes, 0)\n\n mstore(0x40, add(tempBytes, 0x20))\n }\n }\n\n return tempBytes;\n }\n\n function toAddress(bytes memory _bytes, uint _start) internal pure returns (address) {\n require(_bytes.length >= _start + 20, \"toAddress_outOfBounds\");\n address tempAddress;\n\n assembly {\n tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)\n }\n\n return tempAddress;\n }\n\n function toUint8(bytes memory _bytes, uint _start) internal pure returns (uint8) {\n require(_bytes.length >= _start + 1, \"toUint8_outOfBounds\");\n uint8 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x1), _start))\n }\n\n return tempUint;\n }\n\n function toUint16(bytes memory _bytes, uint _start) internal pure returns (uint16) {\n require(_bytes.length >= _start + 2, \"toUint16_outOfBounds\");\n uint16 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x2), _start))\n }\n\n return tempUint;\n }\n\n function toUint32(bytes memory _bytes, uint _start) internal pure returns (uint32) {\n require(_bytes.length >= _start + 4, \"toUint32_outOfBounds\");\n uint32 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x4), _start))\n }\n\n return tempUint;\n }\n\n function toUint64(bytes memory _bytes, uint _start) internal pure returns (uint64) {\n require(_bytes.length >= _start + 8, \"toUint64_outOfBounds\");\n uint64 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x8), _start))\n }\n\n return tempUint;\n }\n\n function toUint96(bytes memory _bytes, uint _start) internal pure returns (uint96) {\n require(_bytes.length >= _start + 12, \"toUint96_outOfBounds\");\n uint96 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0xc), _start))\n }\n\n return tempUint;\n }\n\n function toUint128(bytes memory _bytes, uint _start) internal pure returns (uint128) {\n require(_bytes.length >= _start + 16, \"toUint128_outOfBounds\");\n uint128 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x10), _start))\n }\n\n return tempUint;\n }\n\n function toUint256(bytes memory _bytes, uint _start) internal pure returns (uint) {\n require(_bytes.length >= _start + 32, \"toUint256_outOfBounds\");\n uint tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x20), _start))\n }\n\n return tempUint;\n }\n\n function toBytes32(bytes memory _bytes, uint _start) internal pure returns (bytes32) {\n require(_bytes.length >= _start + 32, \"toBytes32_outOfBounds\");\n bytes32 tempBytes32;\n\n assembly {\n tempBytes32 := mload(add(add(_bytes, 0x20), _start))\n }\n\n return tempBytes32;\n }\n\n function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {\n bool success = true;\n\n assembly {\n let length := mload(_preBytes)\n\n // if lengths don't match the arrays are not equal\n switch eq(length, mload(_postBytes))\n case 1 {\n // cb is a circuit breaker in the for loop since there's\n // no said feature for inline assembly loops\n // cb = 1 - don't breaker\n // cb = 0 - break\n let cb := 1\n\n let mc := add(_preBytes, 0x20)\n let end := add(mc, length)\n\n for {\n let cc := add(_postBytes, 0x20)\n // the next line is the loop condition:\n // while(uint256(mc < end) + cb == 2)\n } eq(add(lt(mc, end), cb), 2) {\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n // if any of these checks fails then arrays are not equal\n if iszero(eq(mload(mc), mload(cc))) {\n // unsuccess:\n success := 0\n cb := 0\n }\n }\n }\n default {\n // unsuccess:\n success := 0\n }\n }\n\n return success;\n }\n\n function equalStorage(bytes storage _preBytes, bytes memory _postBytes) internal view returns (bool) {\n bool success = true;\n\n assembly {\n // we know _preBytes_offset is 0\n let fslot := sload(_preBytes.slot)\n // Decode the length of the stored array like in concatStorage().\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\n let mlength := mload(_postBytes)\n\n // if lengths don't match the arrays are not equal\n switch eq(slength, mlength)\n case 1 {\n // slength can contain both the length and contents of the array\n // if length < 32 bytes so let's prepare for that\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\n if iszero(iszero(slength)) {\n switch lt(slength, 32)\n case 1 {\n // blank the last byte which is the length\n fslot := mul(div(fslot, 0x100), 0x100)\n\n if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {\n // unsuccess:\n success := 0\n }\n }\n default {\n // cb is a circuit breaker in the for loop since there's\n // no said feature for inline assembly loops\n // cb = 1 - don't breaker\n // cb = 0 - break\n let cb := 1\n\n // get the keccak hash to get the contents of the array\n mstore(0x0, _preBytes.slot)\n let sc := keccak256(0x0, 0x20)\n\n let mc := add(_postBytes, 0x20)\n let end := add(mc, mlength)\n\n // the next line is the loop condition:\n // while(uint256(mc < end) + cb == 2)\n for {\n\n } eq(add(lt(mc, end), cb), 2) {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } {\n if iszero(eq(sload(sc), mload(mc))) {\n // unsuccess:\n success := 0\n cb := 0\n }\n }\n }\n }\n }\n default {\n // unsuccess:\n success := 0\n }\n }\n\n return success;\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/libraries/ExcessivelySafeCall.sol": { + "content": "// SPDX-License-Identifier: MIT OR Apache-2.0\npragma solidity >=0.7.6;\n\nlibrary ExcessivelySafeCall {\n uint constant LOW_28_MASK = 0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;\n\n /// @notice Use when you _really_ really _really_ don't trust the called\n /// contract. This prevents the called contract from causing reversion of\n /// the caller in as many ways as we can.\n /// @dev The main difference between this and a solidity low-level call is\n /// that we limit the number of bytes that the callee can cause to be\n /// copied to caller memory. This prevents stupid things like malicious\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\n /// to memory.\n /// @param _target The address to call\n /// @param _gas The amount of gas to forward to the remote contract\n /// @param _maxCopy The maximum number of bytes of returndata to copy\n /// to memory.\n /// @param _calldata The data to send to the remote contract\n /// @return success and returndata, as `.call()`. Returndata is capped to\n /// `_maxCopy` bytes.\n function excessivelySafeCall(\n address _target,\n uint _gas,\n uint16 _maxCopy,\n bytes memory _calldata\n ) internal returns (bool, bytes memory) {\n // set up for assembly call\n uint _toCopy;\n bool _success;\n bytes memory _returnData = new bytes(_maxCopy);\n // dispatch message to recipient\n // by assembly calling \"handle\" function\n // we call via assembly to avoid memcopying a very large returndata\n // returned by a malicious contract\n assembly {\n _success := call(\n _gas, // gas\n _target, // recipient\n 0, // ether value\n add(_calldata, 0x20), // inloc\n mload(_calldata), // inlen\n 0, // outloc\n 0 // outlen\n )\n // limit our copy to 256 bytes\n _toCopy := returndatasize()\n if gt(_toCopy, _maxCopy) {\n _toCopy := _maxCopy\n }\n // Store the length of the copied bytes\n mstore(_returnData, _toCopy)\n // copy the bytes from returndata[0:_toCopy]\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\n }\n return (_success, _returnData);\n }\n\n /// @notice Use when you _really_ really _really_ don't trust the called\n /// contract. This prevents the called contract from causing reversion of\n /// the caller in as many ways as we can.\n /// @dev The main difference between this and a solidity low-level call is\n /// that we limit the number of bytes that the callee can cause to be\n /// copied to caller memory. This prevents stupid things like malicious\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\n /// to memory.\n /// @param _target The address to call\n /// @param _gas The amount of gas to forward to the remote contract\n /// @param _maxCopy The maximum number of bytes of returndata to copy\n /// to memory.\n /// @param _calldata The data to send to the remote contract\n /// @return success and returndata, as `.call()`. Returndata is capped to\n /// `_maxCopy` bytes.\n function excessivelySafeStaticCall(\n address _target,\n uint _gas,\n uint16 _maxCopy,\n bytes memory _calldata\n ) internal view returns (bool, bytes memory) {\n // set up for assembly call\n uint _toCopy;\n bool _success;\n bytes memory _returnData = new bytes(_maxCopy);\n // dispatch message to recipient\n // by assembly calling \"handle\" function\n // we call via assembly to avoid memcopying a very large returndata\n // returned by a malicious contract\n assembly {\n _success := staticcall(\n _gas, // gas\n _target, // recipient\n add(_calldata, 0x20), // inloc\n mload(_calldata), // inlen\n 0, // outloc\n 0 // outlen\n )\n // limit our copy to 256 bytes\n _toCopy := returndatasize()\n if gt(_toCopy, _maxCopy) {\n _toCopy := _maxCopy\n }\n // Store the length of the copied bytes\n mstore(_returnData, _toCopy)\n // copy the bytes from returndata[0:_toCopy]\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\n }\n return (_success, _returnData);\n }\n\n /**\n * @notice Swaps function selectors in encoded contract calls\n * @dev Allows reuse of encoded calldata for functions with identical\n * argument types but different names. It simply swaps out the first 4 bytes\n * for the new selector. This function modifies memory in place, and should\n * only be used with caution.\n * @param _newSelector The new 4-byte selector\n * @param _buf The encoded contract args\n */\n function swapSelector(bytes4 _newSelector, bytes memory _buf) internal pure {\n require(_buf.length >= 4);\n uint _mask = LOW_28_MASK;\n assembly {\n // load the first word of\n let _word := mload(add(_buf, 0x20))\n // mask out the top 4 bytes\n // /x\n _word := and(_word, _mask)\n _word := or(_newSelector, _word)\n mstore(add(_buf, 0x20), _word)\n }\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroEndpoint.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\nimport \"./ILayerZeroUserApplicationConfig.sol\";\n\ninterface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {\n // @notice send a LayerZero message to the specified address at a LayerZero endpoint.\n // @param _dstChainId - the destination chain identifier\n // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains\n // @param _payload - a custom bytes payload to send to the destination contract\n // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address\n // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction\n // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination\n function send(\n uint16 _dstChainId,\n bytes calldata _destination,\n bytes calldata _payload,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes calldata _adapterParams\n ) external payable;\n\n // @notice used by the messaging library to publish verified payload\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source contract (as bytes) at the source chain\n // @param _dstAddress - the address on destination chain\n // @param _nonce - the unbound message ordering nonce\n // @param _gasLimit - the gas limit for external contract execution\n // @param _payload - verified payload to send to the destination contract\n function receivePayload(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n address _dstAddress,\n uint64 _nonce,\n uint _gasLimit,\n bytes calldata _payload\n ) external;\n\n // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source chain contract address\n function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);\n\n // @notice get the outboundNonce from this source chain which, consequently, is always an EVM\n // @param _srcAddress - the source chain contract address\n function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);\n\n // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery\n // @param _dstChainId - the destination chain identifier\n // @param _userApplication - the user app address on this EVM chain\n // @param _payload - the custom message to send over LayerZero\n // @param _payInZRO - if false, user app pays the protocol fee in native token\n // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain\n function estimateFees(\n uint16 _dstChainId,\n address _userApplication,\n bytes calldata _payload,\n bool _payInZRO,\n bytes calldata _adapterParam\n ) external view returns (uint nativeFee, uint zroFee);\n\n // @notice get this Endpoint's immutable source identifier\n function getChainId() external view returns (uint16);\n\n // @notice the interface to retry failed message on this Endpoint destination\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source chain contract address\n // @param _payload - the payload to be retried\n function retryPayload(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n bytes calldata _payload\n ) external;\n\n // @notice query if any STORED payload (message blocking) at the endpoint.\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source chain contract address\n function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);\n\n // @notice query if the _libraryAddress is valid for sending msgs.\n // @param _userApplication - the user app address on this EVM chain\n function getSendLibraryAddress(address _userApplication) external view returns (address);\n\n // @notice query if the _libraryAddress is valid for receiving msgs.\n // @param _userApplication - the user app address on this EVM chain\n function getReceiveLibraryAddress(address _userApplication) external view returns (address);\n\n // @notice query if the non-reentrancy guard for send() is on\n // @return true if the guard is on. false otherwise\n function isSendingPayload() external view returns (bool);\n\n // @notice query if the non-reentrancy guard for receive() is on\n // @return true if the guard is on. false otherwise\n function isReceivingPayload() external view returns (bool);\n\n // @notice get the configuration of the LayerZero messaging library of the specified version\n // @param _version - messaging library version\n // @param _chainId - the chainId for the pending config change\n // @param _userApplication - the contract address of the user application\n // @param _configType - type of configuration. every messaging library has its own convention.\n function getConfig(\n uint16 _version,\n uint16 _chainId,\n address _userApplication,\n uint _configType\n ) external view returns (bytes memory);\n\n // @notice get the send() LayerZero messaging library version\n // @param _userApplication - the contract address of the user application\n function getSendVersion(address _userApplication) external view returns (uint16);\n\n // @notice get the lzReceive() LayerZero messaging library version\n // @param _userApplication - the contract address of the user application\n function getReceiveVersion(address _userApplication) external view returns (uint16);\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroReceiver.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\ninterface ILayerZeroReceiver {\n // @notice LayerZero endpoint will invoke this function to deliver the message on the destination\n // @param _srcChainId - the source endpoint identifier\n // @param _srcAddress - the source sending contract address from the source chain\n // @param _nonce - the ordered message nonce\n // @param _payload - the signed payload is the UA bytes has encoded to be sent\n function lzReceive(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) external;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroUserApplicationConfig.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\ninterface ILayerZeroUserApplicationConfig {\n // @notice set the configuration of the LayerZero messaging library of the specified version\n // @param _version - messaging library version\n // @param _chainId - the chainId for the pending config change\n // @param _configType - type of configuration. every messaging library has its own convention.\n // @param _config - configuration in the bytes. can encode arbitrary content.\n function setConfig(\n uint16 _version,\n uint16 _chainId,\n uint _configType,\n bytes calldata _config\n ) external;\n\n // @notice set the send() LayerZero messaging library version to _version\n // @param _version - new messaging library version\n function setSendVersion(uint16 _version) external;\n\n // @notice set the lzReceive() LayerZero messaging library version to _version\n // @param _version - new messaging library version\n function setReceiveVersion(uint16 _version) external;\n\n // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload\n // @param _srcChainId - the chainId of the source chain\n // @param _srcAddress - the contract address of the source contract at the source chain\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/libs/LzLib.sol": { + "content": "// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity >=0.6.0;\npragma experimental ABIEncoderV2;\n\nlibrary LzLib {\n // LayerZero communication\n struct CallParams {\n address payable refundAddress;\n address zroPaymentAddress;\n }\n\n //---------------------------------------------------------------------------\n // Address type handling\n\n struct AirdropParams {\n uint airdropAmount;\n bytes32 airdropAddress;\n }\n\n function buildAdapterParams(LzLib.AirdropParams memory _airdropParams, uint _uaGasLimit) internal pure returns (bytes memory adapterParams) {\n if (_airdropParams.airdropAmount == 0 && _airdropParams.airdropAddress == bytes32(0x0)) {\n adapterParams = buildDefaultAdapterParams(_uaGasLimit);\n } else {\n adapterParams = buildAirdropAdapterParams(_uaGasLimit, _airdropParams);\n }\n }\n\n // Build Adapter Params\n function buildDefaultAdapterParams(uint _uaGas) internal pure returns (bytes memory) {\n // txType 1\n // bytes [2 32 ]\n // fields [txType extraGas]\n return abi.encodePacked(uint16(1), _uaGas);\n }\n\n function buildAirdropAdapterParams(uint _uaGas, AirdropParams memory _params) internal pure returns (bytes memory) {\n require(_params.airdropAmount > 0, \"Airdrop amount must be greater than 0\");\n require(_params.airdropAddress != bytes32(0x0), \"Airdrop address must be set\");\n\n // txType 2\n // bytes [2 32 32 bytes[] ]\n // fields [txType extraGas dstNativeAmt dstNativeAddress]\n return abi.encodePacked(uint16(2), _uaGas, _params.airdropAmount, _params.airdropAddress);\n }\n\n function getGasLimit(bytes memory _adapterParams) internal pure returns (uint gasLimit) {\n require(_adapterParams.length == 34 || _adapterParams.length > 66, \"Invalid adapterParams\");\n assembly {\n gasLimit := mload(add(_adapterParams, 34))\n }\n }\n\n // Decode Adapter Params\n function decodeAdapterParams(bytes memory _adapterParams)\n internal\n pure\n returns (\n uint16 txType,\n uint uaGas,\n uint airdropAmount,\n address payable airdropAddress\n )\n {\n require(_adapterParams.length == 34 || _adapterParams.length > 66, \"Invalid adapterParams\");\n assembly {\n txType := mload(add(_adapterParams, 2))\n uaGas := mload(add(_adapterParams, 34))\n }\n require(txType == 1 || txType == 2, \"Unsupported txType\");\n require(uaGas > 0, \"Gas too low\");\n\n if (txType == 2) {\n assembly {\n airdropAmount := mload(add(_adapterParams, 66))\n airdropAddress := mload(add(_adapterParams, 86))\n }\n }\n }\n\n //---------------------------------------------------------------------------\n // Address type handling\n function bytes32ToAddress(bytes32 _bytes32Address) internal pure returns (address _address) {\n return address(uint160(uint(_bytes32Address)));\n }\n\n function addressToBytes32(address _address) internal pure returns (bytes32 _bytes32Address) {\n return bytes32(uint(uint160(_address)));\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/LzApp.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"./interfaces/ILayerZeroReceiver.sol\";\nimport \"./interfaces/ILayerZeroUserApplicationConfig.sol\";\nimport \"./interfaces/ILayerZeroEndpoint.sol\";\nimport \"../libraries/BytesLib.sol\";\n\n/*\n * a generic LzReceiver implementation\n */\nabstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {\n using BytesLib for bytes;\n\n // ua can not send payload larger than this by default, but it can be changed by the ua owner\n uint public constant DEFAULT_PAYLOAD_SIZE_LIMIT = 10000;\n\n ILayerZeroEndpoint public immutable lzEndpoint;\n mapping(uint16 => bytes) public trustedRemoteLookup;\n mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;\n mapping(uint16 => uint) public payloadSizeLimitLookup;\n address public precrime;\n\n event SetPrecrime(address precrime);\n event SetTrustedRemote(uint16 _remoteChainId, bytes _path);\n event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);\n event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);\n\n constructor(address _endpoint) {\n lzEndpoint = ILayerZeroEndpoint(_endpoint);\n }\n\n function lzReceive(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public virtual override {\n // lzReceive must be called by the endpoint for security\n require(_msgSender() == address(lzEndpoint), \"LzApp: invalid endpoint caller\");\n\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\n // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\n require(\n _srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote),\n \"LzApp: invalid source sending contract\"\n );\n\n _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging\n function _blockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual;\n\n function _lzSend(\n uint16 _dstChainId,\n bytes memory _payload,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams,\n uint _nativeFee\n ) internal virtual {\n bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];\n require(trustedRemote.length != 0, \"LzApp: destination chain is not a trusted source\");\n _checkPayloadSize(_dstChainId, _payload.length);\n lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);\n }\n\n function _checkGasLimit(\n uint16 _dstChainId,\n uint16 _type,\n bytes memory _adapterParams,\n uint _extraGas\n ) internal view virtual {\n uint providedGasLimit = _getGasLimit(_adapterParams);\n uint minGasLimit = minDstGasLookup[_dstChainId][_type];\n require(minGasLimit > 0, \"LzApp: minGasLimit not set\");\n require(providedGasLimit >= minGasLimit + _extraGas, \"LzApp: gas limit is too low\");\n }\n\n function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {\n require(_adapterParams.length >= 34, \"LzApp: invalid adapterParams\");\n assembly {\n gasLimit := mload(add(_adapterParams, 34))\n }\n }\n\n function _checkPayloadSize(uint16 _dstChainId, uint _payloadSize) internal view virtual {\n uint payloadSizeLimit = payloadSizeLimitLookup[_dstChainId];\n if (payloadSizeLimit == 0) {\n // use default if not set\n payloadSizeLimit = DEFAULT_PAYLOAD_SIZE_LIMIT;\n }\n require(_payloadSize <= payloadSizeLimit, \"LzApp: payload size is too large\");\n }\n\n //---------------------------UserApplication config----------------------------------------\n function getConfig(\n uint16 _version,\n uint16 _chainId,\n address,\n uint _configType\n ) external view returns (bytes memory) {\n return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);\n }\n\n // generic config for LayerZero user Application\n function setConfig(\n uint16 _version,\n uint16 _chainId,\n uint _configType,\n bytes calldata _config\n ) external override onlyOwner {\n lzEndpoint.setConfig(_version, _chainId, _configType, _config);\n }\n\n function setSendVersion(uint16 _version) external override onlyOwner {\n lzEndpoint.setSendVersion(_version);\n }\n\n function setReceiveVersion(uint16 _version) external override onlyOwner {\n lzEndpoint.setReceiveVersion(_version);\n }\n\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {\n lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);\n }\n\n // _path = abi.encodePacked(remoteAddress, localAddress)\n // this function set the trusted path for the cross-chain communication\n function setTrustedRemote(uint16 _remoteChainId, bytes calldata _path) external onlyOwner {\n trustedRemoteLookup[_remoteChainId] = _path;\n emit SetTrustedRemote(_remoteChainId, _path);\n }\n\n function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {\n trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));\n emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);\n }\n\n function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {\n bytes memory path = trustedRemoteLookup[_remoteChainId];\n require(path.length != 0, \"LzApp: no trusted path record\");\n return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)\n }\n\n function setPrecrime(address _precrime) external onlyOwner {\n precrime = _precrime;\n emit SetPrecrime(_precrime);\n }\n\n function setMinDstGas(\n uint16 _dstChainId,\n uint16 _packetType,\n uint _minGas\n ) external onlyOwner {\n minDstGasLookup[_dstChainId][_packetType] = _minGas;\n emit SetMinDstGas(_dstChainId, _packetType, _minGas);\n }\n\n // if the size is 0, it means default size limit\n function setPayloadSizeLimit(uint16 _dstChainId, uint _size) external onlyOwner {\n payloadSizeLimitLookup[_dstChainId] = _size;\n }\n\n //--------------------------- VIEW FUNCTION ----------------------------------------\n function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {\n bytes memory trustedSource = trustedRemoteLookup[_srcChainId];\n return keccak256(trustedSource) == keccak256(_srcAddress);\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/mocks/LZEndpointMock.sol": { + "content": "// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity ^0.8.0;\npragma abicoder v2;\n\nimport \"../interfaces/ILayerZeroReceiver.sol\";\nimport \"../interfaces/ILayerZeroEndpoint.sol\";\nimport \"../libs/LzLib.sol\";\n\n/*\nlike a real LayerZero endpoint but can be mocked, which handle message transmission, verification, and receipt.\n- blocking: LayerZero provides ordered delivery of messages from a given sender to a destination chain.\n- non-reentrancy: endpoint has a non-reentrancy guard for both the send() and receive(), respectively.\n- adapter parameters: allows UAs to add arbitrary transaction params in the send() function, like airdrop on destination chain.\nunlike a real LayerZero endpoint, it is\n- no messaging library versioning\n- send() will short circuit to lzReceive()\n- no user application configuration\n*/\ncontract LZEndpointMock is ILayerZeroEndpoint {\n uint8 internal constant _NOT_ENTERED = 1;\n uint8 internal constant _ENTERED = 2;\n\n mapping(address => address) public lzEndpointLookup;\n\n uint16 public mockChainId;\n bool public nextMsgBlocked;\n\n // fee config\n RelayerFeeConfig public relayerFeeConfig;\n ProtocolFeeConfig public protocolFeeConfig;\n uint public oracleFee;\n bytes public defaultAdapterParams;\n\n // path = remote addrss + local address\n // inboundNonce = [srcChainId][path].\n mapping(uint16 => mapping(bytes => uint64)) public inboundNonce;\n //todo: this is a hack\n // outboundNonce = [dstChainId][srcAddress]\n mapping(uint16 => mapping(address => uint64)) public outboundNonce;\n // // outboundNonce = [dstChainId][path].\n // mapping(uint16 => mapping(bytes => uint64)) public outboundNonce;\n // storedPayload = [srcChainId][path]\n mapping(uint16 => mapping(bytes => StoredPayload)) public storedPayload;\n // msgToDeliver = [srcChainId][path]\n mapping(uint16 => mapping(bytes => QueuedPayload[])) public msgsToDeliver;\n\n // reentrancy guard\n uint8 internal _send_entered_state = 1;\n uint8 internal _receive_entered_state = 1;\n\n struct ProtocolFeeConfig {\n uint zroFee;\n uint nativeBP;\n }\n\n struct RelayerFeeConfig {\n uint128 dstPriceRatio; // 10^10\n uint128 dstGasPriceInWei;\n uint128 dstNativeAmtCap;\n uint64 baseGas;\n uint64 gasPerByte;\n }\n\n struct StoredPayload {\n uint64 payloadLength;\n address dstAddress;\n bytes32 payloadHash;\n }\n\n struct QueuedPayload {\n address dstAddress;\n uint64 nonce;\n bytes payload;\n }\n\n modifier sendNonReentrant() {\n require(_send_entered_state == _NOT_ENTERED, \"LayerZeroMock: no send reentrancy\");\n _send_entered_state = _ENTERED;\n _;\n _send_entered_state = _NOT_ENTERED;\n }\n\n modifier receiveNonReentrant() {\n require(_receive_entered_state == _NOT_ENTERED, \"LayerZeroMock: no receive reentrancy\");\n _receive_entered_state = _ENTERED;\n _;\n _receive_entered_state = _NOT_ENTERED;\n }\n\n event UaForceResumeReceive(uint16 chainId, bytes srcAddress);\n event PayloadCleared(uint16 srcChainId, bytes srcAddress, uint64 nonce, address dstAddress);\n event PayloadStored(uint16 srcChainId, bytes srcAddress, address dstAddress, uint64 nonce, bytes payload, bytes reason);\n event ValueTransferFailed(address indexed to, uint indexed quantity);\n\n constructor(uint16 _chainId) {\n mockChainId = _chainId;\n\n // init config\n relayerFeeConfig = RelayerFeeConfig({\n dstPriceRatio: 1e10, // 1:1, same chain, same native coin\n dstGasPriceInWei: 1e10,\n dstNativeAmtCap: 1e19,\n baseGas: 100,\n gasPerByte: 1\n });\n protocolFeeConfig = ProtocolFeeConfig({zroFee: 1e18, nativeBP: 1000}); // BP 0.1\n oracleFee = 1e16;\n defaultAdapterParams = LzLib.buildDefaultAdapterParams(200000);\n }\n\n // ------------------------------ ILayerZeroEndpoint Functions ------------------------------\n function send(\n uint16 _chainId,\n bytes memory _path,\n bytes calldata _payload,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) external payable override sendNonReentrant {\n require(_path.length == 40, \"LayerZeroMock: incorrect remote address size\"); // only support evm chains\n\n address dstAddr;\n assembly {\n dstAddr := mload(add(_path, 20))\n }\n\n address lzEndpoint = lzEndpointLookup[dstAddr];\n require(lzEndpoint != address(0), \"LayerZeroMock: destination LayerZero Endpoint not found\");\n\n // not handle zro token\n bytes memory adapterParams = _adapterParams.length > 0 ? _adapterParams : defaultAdapterParams;\n (uint nativeFee, ) = estimateFees(_chainId, msg.sender, _payload, _zroPaymentAddress != address(0x0), adapterParams);\n require(msg.value >= nativeFee, \"LayerZeroMock: not enough native for fees\");\n\n uint64 nonce = ++outboundNonce[_chainId][msg.sender];\n\n // refund if they send too much\n uint amount = msg.value - nativeFee;\n if (amount > 0) {\n (bool success, ) = _refundAddress.call{value: amount}(\"\");\n require(success, \"LayerZeroMock: failed to refund\");\n }\n\n // Mock the process of receiving msg on dst chain\n // Mock the relayer paying the dstNativeAddr the amount of extra native token\n (, uint extraGas, uint dstNativeAmt, address payable dstNativeAddr) = LzLib.decodeAdapterParams(adapterParams);\n if (dstNativeAmt > 0) {\n (bool success, ) = dstNativeAddr.call{value: dstNativeAmt}(\"\");\n if (!success) {\n emit ValueTransferFailed(dstNativeAddr, dstNativeAmt);\n }\n }\n\n bytes memory srcUaAddress = abi.encodePacked(msg.sender, dstAddr); // cast this address to bytes\n bytes memory payload = _payload;\n LZEndpointMock(lzEndpoint).receivePayload(mockChainId, srcUaAddress, dstAddr, nonce, extraGas, payload);\n }\n\n function receivePayload(\n uint16 _srcChainId,\n bytes calldata _path,\n address _dstAddress,\n uint64 _nonce,\n uint _gasLimit,\n bytes calldata _payload\n ) external override receiveNonReentrant {\n StoredPayload storage sp = storedPayload[_srcChainId][_path];\n\n // assert and increment the nonce. no message shuffling\n require(_nonce == ++inboundNonce[_srcChainId][_path], \"LayerZeroMock: wrong nonce\");\n\n // queue the following msgs inside of a stack to simulate a successful send on src, but not fully delivered on dst\n if (sp.payloadHash != bytes32(0)) {\n QueuedPayload[] storage msgs = msgsToDeliver[_srcChainId][_path];\n QueuedPayload memory newMsg = QueuedPayload(_dstAddress, _nonce, _payload);\n\n // warning, might run into gas issues trying to forward through a bunch of queued msgs\n // shift all the msgs over so we can treat this like a fifo via array.pop()\n if (msgs.length > 0) {\n // extend the array\n msgs.push(newMsg);\n\n // shift all the indexes up for pop()\n for (uint i = 0; i < msgs.length - 1; i++) {\n msgs[i + 1] = msgs[i];\n }\n\n // put the newMsg at the bottom of the stack\n msgs[0] = newMsg;\n } else {\n msgs.push(newMsg);\n }\n } else if (nextMsgBlocked) {\n storedPayload[_srcChainId][_path] = StoredPayload(uint64(_payload.length), _dstAddress, keccak256(_payload));\n emit PayloadStored(_srcChainId, _path, _dstAddress, _nonce, _payload, bytes(\"\"));\n // ensure the next msgs that go through are no longer blocked\n nextMsgBlocked = false;\n } else {\n try ILayerZeroReceiver(_dstAddress).lzReceive{gas: _gasLimit}(_srcChainId, _path, _nonce, _payload) {} catch (bytes memory reason) {\n storedPayload[_srcChainId][_path] = StoredPayload(uint64(_payload.length), _dstAddress, keccak256(_payload));\n emit PayloadStored(_srcChainId, _path, _dstAddress, _nonce, _payload, reason);\n // ensure the next msgs that go through are no longer blocked\n nextMsgBlocked = false;\n }\n }\n }\n\n function getInboundNonce(uint16 _chainID, bytes calldata _path) external view override returns (uint64) {\n return inboundNonce[_chainID][_path];\n }\n\n function getOutboundNonce(uint16 _chainID, address _srcAddress) external view override returns (uint64) {\n return outboundNonce[_chainID][_srcAddress];\n }\n\n function estimateFees(\n uint16 _dstChainId,\n address _userApplication,\n bytes memory _payload,\n bool _payInZRO,\n bytes memory _adapterParams\n ) public view override returns (uint nativeFee, uint zroFee) {\n bytes memory adapterParams = _adapterParams.length > 0 ? _adapterParams : defaultAdapterParams;\n\n // Relayer Fee\n uint relayerFee = _getRelayerFee(_dstChainId, 1, _userApplication, _payload.length, adapterParams);\n\n // LayerZero Fee\n uint protocolFee = _getProtocolFees(_payInZRO, relayerFee, oracleFee);\n _payInZRO ? zroFee = protocolFee : nativeFee = protocolFee;\n\n // return the sum of fees\n nativeFee = nativeFee + relayerFee + oracleFee;\n }\n\n function getChainId() external view override returns (uint16) {\n return mockChainId;\n }\n\n function retryPayload(\n uint16 _srcChainId,\n bytes calldata _path,\n bytes calldata _payload\n ) external override {\n StoredPayload storage sp = storedPayload[_srcChainId][_path];\n require(sp.payloadHash != bytes32(0), \"LayerZeroMock: no stored payload\");\n require(_payload.length == sp.payloadLength && keccak256(_payload) == sp.payloadHash, \"LayerZeroMock: invalid payload\");\n\n address dstAddress = sp.dstAddress;\n // empty the storedPayload\n sp.payloadLength = 0;\n sp.dstAddress = address(0);\n sp.payloadHash = bytes32(0);\n\n uint64 nonce = inboundNonce[_srcChainId][_path];\n\n ILayerZeroReceiver(dstAddress).lzReceive(_srcChainId, _path, nonce, _payload);\n emit PayloadCleared(_srcChainId, _path, nonce, dstAddress);\n }\n\n function hasStoredPayload(uint16 _srcChainId, bytes calldata _path) external view override returns (bool) {\n StoredPayload storage sp = storedPayload[_srcChainId][_path];\n return sp.payloadHash != bytes32(0);\n }\n\n function getSendLibraryAddress(address) external view override returns (address) {\n return address(this);\n }\n\n function getReceiveLibraryAddress(address) external view override returns (address) {\n return address(this);\n }\n\n function isSendingPayload() external view override returns (bool) {\n return _send_entered_state == _ENTERED;\n }\n\n function isReceivingPayload() external view override returns (bool) {\n return _receive_entered_state == _ENTERED;\n }\n\n function getConfig(\n uint16, /*_version*/\n uint16, /*_chainId*/\n address, /*_ua*/\n uint /*_configType*/\n ) external pure override returns (bytes memory) {\n return \"\";\n }\n\n function getSendVersion(\n address /*_userApplication*/\n ) external pure override returns (uint16) {\n return 1;\n }\n\n function getReceiveVersion(\n address /*_userApplication*/\n ) external pure override returns (uint16) {\n return 1;\n }\n\n function setConfig(\n uint16, /*_version*/\n uint16, /*_chainId*/\n uint, /*_configType*/\n bytes memory /*_config*/\n ) external override {}\n\n function setSendVersion(\n uint16 /*version*/\n ) external override {}\n\n function setReceiveVersion(\n uint16 /*version*/\n ) external override {}\n\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _path) external override {\n StoredPayload storage sp = storedPayload[_srcChainId][_path];\n // revert if no messages are cached. safeguard malicious UA behaviour\n require(sp.payloadHash != bytes32(0), \"LayerZeroMock: no stored payload\");\n require(sp.dstAddress == msg.sender, \"LayerZeroMock: invalid caller\");\n\n // empty the storedPayload\n sp.payloadLength = 0;\n sp.dstAddress = address(0);\n sp.payloadHash = bytes32(0);\n\n emit UaForceResumeReceive(_srcChainId, _path);\n\n // resume the receiving of msgs after we force clear the \"stuck\" msg\n _clearMsgQue(_srcChainId, _path);\n }\n\n // ------------------------------ Other Public/External Functions --------------------------------------------------\n\n function getLengthOfQueue(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint) {\n return msgsToDeliver[_srcChainId][_srcAddress].length;\n }\n\n // used to simulate messages received get stored as a payload\n function blockNextMsg() external {\n nextMsgBlocked = true;\n }\n\n function setDestLzEndpoint(address destAddr, address lzEndpointAddr) external {\n lzEndpointLookup[destAddr] = lzEndpointAddr;\n }\n\n function setRelayerPrice(\n uint128 _dstPriceRatio,\n uint128 _dstGasPriceInWei,\n uint128 _dstNativeAmtCap,\n uint64 _baseGas,\n uint64 _gasPerByte\n ) external {\n relayerFeeConfig.dstPriceRatio = _dstPriceRatio;\n relayerFeeConfig.dstGasPriceInWei = _dstGasPriceInWei;\n relayerFeeConfig.dstNativeAmtCap = _dstNativeAmtCap;\n relayerFeeConfig.baseGas = _baseGas;\n relayerFeeConfig.gasPerByte = _gasPerByte;\n }\n\n function setProtocolFee(uint _zroFee, uint _nativeBP) external {\n protocolFeeConfig.zroFee = _zroFee;\n protocolFeeConfig.nativeBP = _nativeBP;\n }\n\n function setOracleFee(uint _oracleFee) external {\n oracleFee = _oracleFee;\n }\n\n function setDefaultAdapterParams(bytes memory _adapterParams) external {\n defaultAdapterParams = _adapterParams;\n }\n\n // --------------------- Internal Functions ---------------------\n // simulates the relayer pushing through the rest of the msgs that got delayed due to the stored payload\n function _clearMsgQue(uint16 _srcChainId, bytes calldata _path) internal {\n QueuedPayload[] storage msgs = msgsToDeliver[_srcChainId][_path];\n\n // warning, might run into gas issues trying to forward through a bunch of queued msgs\n while (msgs.length > 0) {\n QueuedPayload memory payload = msgs[msgs.length - 1];\n ILayerZeroReceiver(payload.dstAddress).lzReceive(_srcChainId, _path, payload.nonce, payload.payload);\n msgs.pop();\n }\n }\n\n function _getProtocolFees(\n bool _payInZro,\n uint _relayerFee,\n uint _oracleFee\n ) internal view returns (uint) {\n if (_payInZro) {\n return protocolFeeConfig.zroFee;\n } else {\n return ((_relayerFee + _oracleFee) * protocolFeeConfig.nativeBP) / 10000;\n }\n }\n\n function _getRelayerFee(\n uint16, /* _dstChainId */\n uint16, /* _outboundProofType */\n address, /* _userApplication */\n uint _payloadSize,\n bytes memory _adapterParams\n ) internal view returns (uint) {\n (uint16 txType, uint extraGas, uint dstNativeAmt, ) = LzLib.decodeAdapterParams(_adapterParams);\n uint totalRemoteToken; // = baseGas + extraGas + requiredNativeAmount\n if (txType == 2) {\n require(relayerFeeConfig.dstNativeAmtCap >= dstNativeAmt, \"LayerZeroMock: dstNativeAmt too large \");\n totalRemoteToken += dstNativeAmt;\n }\n // remoteGasTotal = dstGasPriceInWei * (baseGas + extraGas)\n uint remoteGasTotal = relayerFeeConfig.dstGasPriceInWei * (relayerFeeConfig.baseGas + extraGas);\n totalRemoteToken += remoteGasTotal;\n\n // tokenConversionRate = dstPrice / localPrice\n // basePrice = totalRemoteToken * tokenConversionRate\n uint basePrice = (totalRemoteToken * relayerFeeConfig.dstPriceRatio) / 10**10;\n\n // pricePerByte = (dstGasPriceInWei * gasPerBytes) * tokenConversionRate\n uint pricePerByte = (relayerFeeConfig.dstGasPriceInWei * relayerFeeConfig.gasPerByte * relayerFeeConfig.dstPriceRatio) / 10**10;\n\n return basePrice + _payloadSize * pricePerByte;\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/NonblockingLzApp.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"./LzApp.sol\";\nimport \"../libraries/ExcessivelySafeCall.sol\";\n\n/*\n * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel\n * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking\n * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)\n */\nabstract contract NonblockingLzApp is LzApp {\n using ExcessivelySafeCall for address;\n\n constructor(address _endpoint) LzApp(_endpoint) {}\n\n mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;\n\n event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);\n event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);\n\n // overriding the virtual function in LzReceiver\n function _blockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual override {\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\n gasleft(),\n 150,\n abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload)\n );\n // try-catch all errors/exceptions\n if (!success) {\n _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);\n }\n }\n\n function _storeFailedMessage(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload,\n bytes memory _reason\n ) internal virtual {\n failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);\n emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);\n }\n\n function nonblockingLzReceive(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public virtual {\n // only internal transaction\n require(_msgSender() == address(this), \"NonblockingLzApp: caller must be LzApp\");\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n //@notice override this function\n function _nonblockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual;\n\n function retryMessage(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public payable virtual {\n // assert there is message to retry\n bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];\n require(payloadHash != bytes32(0), \"NonblockingLzApp: no stored message\");\n require(keccak256(_payload) == payloadHash, \"NonblockingLzApp: invalid payload\");\n // clear the stored message\n failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);\n // execute the message. revert if it fails again\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\n emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"./OFTCoreV2.sol\";\nimport \"./interfaces/IOFTV2.sol\";\nimport \"@openzeppelin/contracts/utils/introspection/ERC165.sol\";\n\nabstract contract BaseOFTV2 is OFTCoreV2, ERC165, IOFTV2 {\n constructor(uint8 _sharedDecimals, address _lzEndpoint) OFTCoreV2(_sharedDecimals, _lzEndpoint) {}\n\n /************************************************************************\n * public functions\n ************************************************************************/\n function sendFrom(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n LzCallParams calldata _callParams\n ) public payable virtual override {\n _send(_from, _dstChainId, _toAddress, _amount, _callParams.refundAddress, _callParams.zroPaymentAddress, _callParams.adapterParams);\n }\n\n function sendAndCall(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes calldata _payload,\n uint64 _dstGasForCall,\n LzCallParams calldata _callParams\n ) public payable virtual override {\n _sendAndCall(\n _from,\n _dstChainId,\n _toAddress,\n _amount,\n _payload,\n _dstGasForCall,\n _callParams.refundAddress,\n _callParams.zroPaymentAddress,\n _callParams.adapterParams\n );\n }\n\n /************************************************************************\n * public view functions\n ************************************************************************/\n function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {\n return interfaceId == type(IOFTV2).interfaceId || super.supportsInterface(interfaceId);\n }\n\n function estimateSendFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bool _useZro,\n bytes calldata _adapterParams\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\n return _estimateSendFee(_dstChainId, _toAddress, _amount, _useZro, _adapterParams);\n }\n\n function estimateSendAndCallFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes calldata _payload,\n uint64 _dstGasForCall,\n bool _useZro,\n bytes calldata _adapterParams\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\n return _estimateSendAndCallFee(_dstChainId, _toAddress, _amount, _payload, _dstGasForCall, _useZro, _adapterParams);\n }\n\n function circulatingSupply() public view virtual override returns (uint);\n\n function token() public view virtual override returns (address);\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/ICommonOFT.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\nimport \"@openzeppelin/contracts/utils/introspection/IERC165.sol\";\n\n/**\n * @dev Interface of the IOFT core standard\n */\ninterface ICommonOFT is IERC165 {\n\n struct LzCallParams {\n address payable refundAddress;\n address zroPaymentAddress;\n bytes adapterParams;\n }\n\n /**\n * @dev estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`)\n * _dstChainId - L0 defined chain id to send tokens too\n * _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain\n * _amount - amount of the tokens to transfer\n * _useZro - indicates to use zro to pay L0 fees\n * _adapterParam - flexible bytes array to indicate messaging adapter services in L0\n */\n function estimateSendFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\n\n function estimateSendAndCallFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\n\n /**\n * @dev returns the circulating amount of tokens on current chain\n */\n function circulatingSupply() external view returns (uint);\n\n /**\n * @dev returns the address of the ERC20 token\n */\n function token() external view returns (address);\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTReceiverV2.sol": { + "content": "// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity >=0.5.0;\n\ninterface IOFTReceiverV2 {\n /**\n * @dev Called by the OFT contract when tokens are received from source chain.\n * @param _srcChainId The chain id of the source chain.\n * @param _srcAddress The address of the OFT token contract on the source chain.\n * @param _nonce The nonce of the transaction on the source chain.\n * @param _from The address of the account who calls the sendAndCall() on the source chain.\n * @param _amount The amount of tokens to transfer.\n * @param _payload Additional data with no specified format.\n */\n function onOFTReceived(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes32 _from, uint _amount, bytes calldata _payload) external;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTV2.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\nimport \"./ICommonOFT.sol\";\n\n/**\n * @dev Interface of the IOFT core standard\n */\ninterface IOFTV2 is ICommonOFT {\n\n /**\n * @dev send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from`\n * `_from` the owner of token\n * `_dstChainId` the destination chain identifier\n * `_toAddress` can be any size depending on the `dstChainId`.\n * `_amount` the quantity of tokens in wei\n * `_refundAddress` the address LayerZero refunds if too much message fee is sent\n * `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token)\n * `_adapterParams` is a flexible bytes array to indicate messaging adapter services\n */\n function sendFrom(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, LzCallParams calldata _callParams) external payable;\n\n function sendAndCall(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, LzCallParams calldata _callParams) external payable;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/OFTCoreV2.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"../../../lzApp/NonblockingLzApp.sol\";\nimport \"../../../libraries/ExcessivelySafeCall.sol\";\nimport \"./interfaces/ICommonOFT.sol\";\nimport \"./interfaces/IOFTReceiverV2.sol\";\n\nabstract contract OFTCoreV2 is NonblockingLzApp {\n using BytesLib for bytes;\n using ExcessivelySafeCall for address;\n\n uint public constant NO_EXTRA_GAS = 0;\n\n // packet type\n uint8 public constant PT_SEND = 0;\n uint8 public constant PT_SEND_AND_CALL = 1;\n\n uint8 public immutable sharedDecimals;\n\n mapping(uint16 => mapping(bytes => mapping(uint64 => bool))) public creditedPackets;\n\n /**\n * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)\n * `_nonce` is the outbound nonce\n */\n event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes32 indexed _toAddress, uint _amount);\n\n /**\n * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.\n * `_nonce` is the inbound nonce.\n */\n event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);\n\n event CallOFTReceivedSuccess(uint16 indexed _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _hash);\n\n event NonContractAddress(address _address);\n\n // _sharedDecimals should be the minimum decimals on all chains\n constructor(uint8 _sharedDecimals, address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {\n sharedDecimals = _sharedDecimals;\n }\n\n /************************************************************************\n * public functions\n ************************************************************************/\n function callOnOFTReceived(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes32 _from,\n address _to,\n uint _amount,\n bytes calldata _payload,\n uint _gasForCall\n ) public virtual {\n require(_msgSender() == address(this), \"OFTCore: caller must be OFTCore\");\n\n // send\n _amount = _transferFrom(address(this), _to, _amount);\n emit ReceiveFromChain(_srcChainId, _to, _amount);\n\n // call\n IOFTReceiverV2(_to).onOFTReceived{gas: _gasForCall}(_srcChainId, _srcAddress, _nonce, _from, _amount, _payload);\n }\n\n /************************************************************************\n * internal functions\n ************************************************************************/\n function _estimateSendFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bool _useZro,\n bytes memory _adapterParams\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\n // mock the payload for sendFrom()\n bytes memory payload = _encodeSendPayload(_toAddress, _ld2sd(_amount));\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\n }\n\n function _estimateSendAndCallFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes memory _payload,\n uint64 _dstGasForCall,\n bool _useZro,\n bytes memory _adapterParams\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\n // mock the payload for sendAndCall()\n bytes memory payload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(_amount), _payload, _dstGasForCall);\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\n }\n\n function _nonblockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual override {\n uint8 packetType = _payload.toUint8(0);\n\n if (packetType == PT_SEND) {\n _sendAck(_srcChainId, _srcAddress, _nonce, _payload);\n } else if (packetType == PT_SEND_AND_CALL) {\n _sendAndCallAck(_srcChainId, _srcAddress, _nonce, _payload);\n } else {\n revert(\"OFTCore: unknown packet type\");\n }\n }\n\n function _send(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) internal virtual returns (uint amount) {\n _checkGasLimit(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);\n\n (amount, ) = _removeDust(_amount);\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount); // amount returned should not have dust\n require(amount > 0, \"OFTCore: amount too small\");\n\n bytes memory lzPayload = _encodeSendPayload(_toAddress, _ld2sd(amount));\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\n\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\n }\n\n function _sendAck(\n uint16 _srcChainId,\n bytes memory,\n uint64,\n bytes memory _payload\n ) internal virtual {\n (address to, uint64 amountSD) = _decodeSendPayload(_payload);\n if (to == address(0)) {\n to = address(0xdead);\n }\n\n uint amount = _sd2ld(amountSD);\n amount = _creditTo(_srcChainId, to, amount);\n\n emit ReceiveFromChain(_srcChainId, to, amount);\n }\n\n function _sendAndCall(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes memory _payload,\n uint64 _dstGasForCall,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) internal virtual returns (uint amount) {\n _checkGasLimit(_dstChainId, PT_SEND_AND_CALL, _adapterParams, _dstGasForCall);\n\n (amount, ) = _removeDust(_amount);\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount);\n require(amount > 0, \"OFTCore: amount too small\");\n\n // encode the msg.sender into the payload instead of _from\n bytes memory lzPayload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(amount), _payload, _dstGasForCall);\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\n\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\n }\n\n function _sendAndCallAck(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual {\n (bytes32 from, address to, uint64 amountSD, bytes memory payloadForCall, uint64 gasForCall) = _decodeSendAndCallPayload(_payload);\n\n bool credited = creditedPackets[_srcChainId][_srcAddress][_nonce];\n uint amount = _sd2ld(amountSD);\n\n // credit to this contract first, and then transfer to receiver only if callOnOFTReceived() succeeds\n if (!credited) {\n amount = _creditTo(_srcChainId, address(this), amount);\n creditedPackets[_srcChainId][_srcAddress][_nonce] = true;\n }\n\n if (!_isContract(to)) {\n emit NonContractAddress(to);\n return;\n }\n\n // workaround for stack too deep\n uint16 srcChainId = _srcChainId;\n bytes memory srcAddress = _srcAddress;\n uint64 nonce = _nonce;\n bytes memory payload = _payload;\n bytes32 from_ = from;\n address to_ = to;\n uint amount_ = amount;\n bytes memory payloadForCall_ = payloadForCall;\n\n // no gas limit for the call if retry\n uint gas = credited ? gasleft() : gasForCall;\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\n gasleft(),\n 150,\n abi.encodeWithSelector(this.callOnOFTReceived.selector, srcChainId, srcAddress, nonce, from_, to_, amount_, payloadForCall_, gas)\n );\n\n if (success) {\n bytes32 hash = keccak256(payload);\n emit CallOFTReceivedSuccess(srcChainId, srcAddress, nonce, hash);\n } else {\n // store the failed message into the nonblockingLzApp\n _storeFailedMessage(srcChainId, srcAddress, nonce, payload, reason);\n }\n }\n\n function _isContract(address _account) internal view returns (bool) {\n return _account.code.length > 0;\n }\n\n function _ld2sd(uint _amount) internal view virtual returns (uint64) {\n uint amountSD = _amount / _ld2sdRate();\n require(amountSD <= type(uint64).max, \"OFTCore: amountSD overflow\");\n return uint64(amountSD);\n }\n\n function _sd2ld(uint64 _amountSD) internal view virtual returns (uint) {\n return _amountSD * _ld2sdRate();\n }\n\n function _removeDust(uint _amount) internal view virtual returns (uint amountAfter, uint dust) {\n dust = _amount % _ld2sdRate();\n amountAfter = _amount - dust;\n }\n\n function _encodeSendPayload(bytes32 _toAddress, uint64 _amountSD) internal view virtual returns (bytes memory) {\n return abi.encodePacked(PT_SEND, _toAddress, _amountSD);\n }\n\n function _decodeSendPayload(bytes memory _payload) internal view virtual returns (address to, uint64 amountSD) {\n require(_payload.toUint8(0) == PT_SEND && _payload.length == 41, \"OFTCore: invalid payload\");\n\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\n amountSD = _payload.toUint64(33);\n }\n\n function _encodeSendAndCallPayload(\n address _from,\n bytes32 _toAddress,\n uint64 _amountSD,\n bytes memory _payload,\n uint64 _dstGasForCall\n ) internal view virtual returns (bytes memory) {\n return abi.encodePacked(PT_SEND_AND_CALL, _toAddress, _amountSD, _addressToBytes32(_from), _dstGasForCall, _payload);\n }\n\n function _decodeSendAndCallPayload(bytes memory _payload)\n internal\n view\n virtual\n returns (\n bytes32 from,\n address to,\n uint64 amountSD,\n bytes memory payload,\n uint64 dstGasForCall\n )\n {\n require(_payload.toUint8(0) == PT_SEND_AND_CALL, \"OFTCore: invalid payload\");\n\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\n amountSD = _payload.toUint64(33);\n from = _payload.toBytes32(41);\n dstGasForCall = _payload.toUint64(73);\n payload = _payload.slice(81, _payload.length - 81);\n }\n\n function _addressToBytes32(address _address) internal pure virtual returns (bytes32) {\n return bytes32(uint(uint160(_address)));\n }\n\n function _debitFrom(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount\n ) internal virtual returns (uint);\n\n function _creditTo(\n uint16 _srcChainId,\n address _toAddress,\n uint _amount\n ) internal virtual returns (uint);\n\n function _transferFrom(\n address _from,\n address _to,\n uint _amount\n ) internal virtual returns (uint);\n\n function _ld2sdRate() internal view virtual returns (uint);\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./OwnableUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership} and {acceptOwnership}.\n *\n * This module is used through inheritance. It will make available all functions\n * from parent (Ownable).\n */\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\n function __Ownable2Step_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable2Step_init_unchained() internal onlyInitializing {\n }\n address private _pendingOwner;\n\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Returns the address of the pending owner.\n */\n function pendingOwner() public view virtual returns (address) {\n return _pendingOwner;\n }\n\n /**\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual override onlyOwner {\n _pendingOwner = newOwner;\n emit OwnershipTransferStarted(owner(), newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual override {\n delete _pendingOwner;\n super._transferOwnership(newOwner);\n }\n\n /**\n * @dev The new owner accepts the ownership transfer.\n */\n function acceptOwnership() public virtual {\n address sender = _msgSender();\n require(pendingOwner() == sender, \"Ownable2Step: caller is not the new owner\");\n _transferOwnership(sender);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n function __Ownable_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable_init_unchained() internal onlyInitializing {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract ContextUpgradeable is Initializable {\n function __Context_init() internal onlyInitializing {\n }\n\n function __Context_init_unchained() internal onlyInitializing {\n }\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n" + }, + "@openzeppelin/contracts/access/AccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControl.sol\";\nimport \"../utils/Context.sol\";\nimport \"../utils/Strings.sol\";\nimport \"../utils/introspection/ERC165.sol\";\n\n/**\n * @dev Contract module that allows children to implement role-based access\n * control mechanisms. This is a lightweight version that doesn't allow enumerating role\n * members except through off-chain means by accessing the contract event logs. Some\n * applications may benefit from on-chain enumerability, for those cases see\n * {AccessControlEnumerable}.\n *\n * Roles are referred to by their `bytes32` identifier. These should be exposed\n * in the external API and be unique. The best way to achieve this is by\n * using `public constant` hash digests:\n *\n * ```solidity\n * bytes32 public constant MY_ROLE = keccak256(\"MY_ROLE\");\n * ```\n *\n * Roles can be used to represent a set of permissions. To restrict access to a\n * function call, use {hasRole}:\n *\n * ```solidity\n * function foo() public {\n * require(hasRole(MY_ROLE, msg.sender));\n * ...\n * }\n * ```\n *\n * Roles can be granted and revoked dynamically via the {grantRole} and\n * {revokeRole} functions. Each role has an associated admin role, and only\n * accounts that have a role's admin role can call {grantRole} and {revokeRole}.\n *\n * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means\n * that only accounts with this role will be able to grant or revoke other\n * roles. More complex role relationships can be created by using\n * {_setRoleAdmin}.\n *\n * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to\n * grant and revoke this role. Extra precautions should be taken to secure\n * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}\n * to enforce additional security measures for this role.\n */\nabstract contract AccessControl is Context, IAccessControl, ERC165 {\n struct RoleData {\n mapping(address => bool) members;\n bytes32 adminRole;\n }\n\n mapping(bytes32 => RoleData) private _roles;\n\n bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;\n\n /**\n * @dev Modifier that checks that an account has a specific role. Reverts\n * with a standardized message including the required role.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n *\n * _Available since v4.1._\n */\n modifier onlyRole(bytes32 role) {\n _checkRole(role);\n _;\n }\n\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);\n }\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) public view virtual override returns (bool) {\n return _roles[role].members[account];\n }\n\n /**\n * @dev Revert with a standard message if `_msgSender()` is missing `role`.\n * Overriding this function changes the behavior of the {onlyRole} modifier.\n *\n * Format of the revert message is described in {_checkRole}.\n *\n * _Available since v4.6._\n */\n function _checkRole(bytes32 role) internal view virtual {\n _checkRole(role, _msgSender());\n }\n\n /**\n * @dev Revert with a standard message if `account` is missing `role`.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n */\n function _checkRole(bytes32 role, address account) internal view virtual {\n if (!hasRole(role, account)) {\n revert(\n string(\n abi.encodePacked(\n \"AccessControl: account \",\n Strings.toHexString(account),\n \" is missing role \",\n Strings.toHexString(uint256(role), 32)\n )\n )\n );\n }\n }\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {\n return _roles[role].adminRole;\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleGranted} event.\n */\n function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _grantRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleRevoked} event.\n */\n function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _revokeRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been revoked `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n *\n * May emit a {RoleRevoked} event.\n */\n function renounceRole(bytes32 role, address account) public virtual override {\n require(account == _msgSender(), \"AccessControl: can only renounce roles for self\");\n\n _revokeRole(role, account);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event. Note that unlike {grantRole}, this function doesn't perform any\n * checks on the calling account.\n *\n * May emit a {RoleGranted} event.\n *\n * [WARNING]\n * ====\n * This function should only be called from the constructor when setting\n * up the initial roles for the system.\n *\n * Using this function in any other way is effectively circumventing the admin\n * system imposed by {AccessControl}.\n * ====\n *\n * NOTE: This function is deprecated in favor of {_grantRole}.\n */\n function _setupRole(bytes32 role, address account) internal virtual {\n _grantRole(role, account);\n }\n\n /**\n * @dev Sets `adminRole` as ``role``'s admin role.\n *\n * Emits a {RoleAdminChanged} event.\n */\n function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {\n bytes32 previousAdminRole = getRoleAdmin(role);\n _roles[role].adminRole = adminRole;\n emit RoleAdminChanged(role, previousAdminRole, adminRole);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleGranted} event.\n */\n function _grantRole(bytes32 role, address account) internal virtual {\n if (!hasRole(role, account)) {\n _roles[role].members[account] = true;\n emit RoleGranted(role, account, _msgSender());\n }\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleRevoked} event.\n */\n function _revokeRole(bytes32 role, address account) internal virtual {\n if (hasRole(role, account)) {\n _roles[role].members[account] = false;\n emit RoleRevoked(role, account, _msgSender());\n }\n }\n}\n" + }, + "@openzeppelin/contracts/access/IAccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev External interface of AccessControl declared to support ERC165 detection.\n */\ninterface IAccessControl {\n /**\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\n *\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\n * {RoleAdminChanged} not being emitted signaling this.\n *\n * _Available since v3.1._\n */\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\n\n /**\n * @dev Emitted when `account` is granted `role`.\n *\n * `sender` is the account that originated the contract call, an admin role\n * bearer except when using {AccessControl-_setupRole}.\n */\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Emitted when `account` is revoked `role`.\n *\n * `sender` is the account that originated the contract call:\n * - if using `revokeRole`, it is the admin role bearer\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\n */\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) external view returns (bool);\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function grantRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function revokeRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been granted `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n */\n function renounceRole(bytes32 role, address account) external;\n}\n" + }, + "@openzeppelin/contracts/access/Ownable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n constructor() {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n}\n" + }, + "@openzeppelin/contracts/security/Pausable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which allows children to implement an emergency stop\n * mechanism that can be triggered by an authorized account.\n *\n * This module is used through inheritance. It will make available the\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\n * the functions of your contract. Note that they will not be pausable by\n * simply including this module, only once the modifiers are put in place.\n */\nabstract contract Pausable is Context {\n /**\n * @dev Emitted when the pause is triggered by `account`.\n */\n event Paused(address account);\n\n /**\n * @dev Emitted when the pause is lifted by `account`.\n */\n event Unpaused(address account);\n\n bool private _paused;\n\n /**\n * @dev Initializes the contract in unpaused state.\n */\n constructor() {\n _paused = false;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is not paused.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n modifier whenNotPaused() {\n _requireNotPaused();\n _;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is paused.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n modifier whenPaused() {\n _requirePaused();\n _;\n }\n\n /**\n * @dev Returns true if the contract is paused, and false otherwise.\n */\n function paused() public view virtual returns (bool) {\n return _paused;\n }\n\n /**\n * @dev Throws if the contract is paused.\n */\n function _requireNotPaused() internal view virtual {\n require(!paused(), \"Pausable: paused\");\n }\n\n /**\n * @dev Throws if the contract is not paused.\n */\n function _requirePaused() internal view virtual {\n require(paused(), \"Pausable: not paused\");\n }\n\n /**\n * @dev Triggers stopped state.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n function _pause() internal virtual whenNotPaused {\n _paused = true;\n emit Paused(_msgSender());\n }\n\n /**\n * @dev Returns to normal state.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n function _unpause() internal virtual whenPaused {\n _paused = false;\n emit Unpaused(_msgSender());\n }\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/ERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC20.sol\";\nimport \"./extensions/IERC20Metadata.sol\";\nimport \"../../utils/Context.sol\";\n\n/**\n * @dev Implementation of the {IERC20} interface.\n *\n * This implementation is agnostic to the way tokens are created. This means\n * that a supply mechanism has to be added in a derived contract using {_mint}.\n * For a generic mechanism see {ERC20PresetMinterPauser}.\n *\n * TIP: For a detailed writeup see our guide\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\n * to implement supply mechanisms].\n *\n * The default value of {decimals} is 18. To change this, you should override\n * this function so it returns a different value.\n *\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\n * instead returning `false` on failure. This behavior is nonetheless\n * conventional and does not conflict with the expectations of ERC20\n * applications.\n *\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\n * This allows applications to reconstruct the allowance for all accounts just\n * by listening to said events. Other implementations of the EIP may not emit\n * these events, as it isn't required by the specification.\n *\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\n * functions have been added to mitigate the well-known issues around setting\n * allowances. See {IERC20-approve}.\n */\ncontract ERC20 is Context, IERC20, IERC20Metadata {\n mapping(address => uint256) private _balances;\n\n mapping(address => mapping(address => uint256)) private _allowances;\n\n uint256 private _totalSupply;\n\n string private _name;\n string private _symbol;\n\n /**\n * @dev Sets the values for {name} and {symbol}.\n *\n * All two of these values are immutable: they can only be set once during\n * construction.\n */\n constructor(string memory name_, string memory symbol_) {\n _name = name_;\n _symbol = symbol_;\n }\n\n /**\n * @dev Returns the name of the token.\n */\n function name() public view virtual override returns (string memory) {\n return _name;\n }\n\n /**\n * @dev Returns the symbol of the token, usually a shorter version of the\n * name.\n */\n function symbol() public view virtual override returns (string memory) {\n return _symbol;\n }\n\n /**\n * @dev Returns the number of decimals used to get its user representation.\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\n *\n * Tokens usually opt for a value of 18, imitating the relationship between\n * Ether and Wei. This is the default value returned by this function, unless\n * it's overridden.\n *\n * NOTE: This information is only used for _display_ purposes: it in\n * no way affects any of the arithmetic of the contract, including\n * {IERC20-balanceOf} and {IERC20-transfer}.\n */\n function decimals() public view virtual override returns (uint8) {\n return 18;\n }\n\n /**\n * @dev See {IERC20-totalSupply}.\n */\n function totalSupply() public view virtual override returns (uint256) {\n return _totalSupply;\n }\n\n /**\n * @dev See {IERC20-balanceOf}.\n */\n function balanceOf(address account) public view virtual override returns (uint256) {\n return _balances[account];\n }\n\n /**\n * @dev See {IERC20-transfer}.\n *\n * Requirements:\n *\n * - `to` cannot be the zero address.\n * - the caller must have a balance of at least `amount`.\n */\n function transfer(address to, uint256 amount) public virtual override returns (bool) {\n address owner = _msgSender();\n _transfer(owner, to, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-allowance}.\n */\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\n return _allowances[owner][spender];\n }\n\n /**\n * @dev See {IERC20-approve}.\n *\n * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\n * `transferFrom`. This is semantically equivalent to an infinite approval.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\n address owner = _msgSender();\n _approve(owner, spender, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-transferFrom}.\n *\n * Emits an {Approval} event indicating the updated allowance. This is not\n * required by the EIP. See the note at the beginning of {ERC20}.\n *\n * NOTE: Does not update the allowance if the current allowance\n * is the maximum `uint256`.\n *\n * Requirements:\n *\n * - `from` and `to` cannot be the zero address.\n * - `from` must have a balance of at least `amount`.\n * - the caller must have allowance for ``from``'s tokens of at least\n * `amount`.\n */\n function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\n address spender = _msgSender();\n _spendAllowance(from, spender, amount);\n _transfer(from, to, amount);\n return true;\n }\n\n /**\n * @dev Atomically increases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\n address owner = _msgSender();\n _approve(owner, spender, allowance(owner, spender) + addedValue);\n return true;\n }\n\n /**\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `spender` must have allowance for the caller of at least\n * `subtractedValue`.\n */\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\n address owner = _msgSender();\n uint256 currentAllowance = allowance(owner, spender);\n require(currentAllowance >= subtractedValue, \"ERC20: decreased allowance below zero\");\n unchecked {\n _approve(owner, spender, currentAllowance - subtractedValue);\n }\n\n return true;\n }\n\n /**\n * @dev Moves `amount` of tokens from `from` to `to`.\n *\n * This internal function is equivalent to {transfer}, and can be used to\n * e.g. implement automatic token fees, slashing mechanisms, etc.\n *\n * Emits a {Transfer} event.\n *\n * Requirements:\n *\n * - `from` cannot be the zero address.\n * - `to` cannot be the zero address.\n * - `from` must have a balance of at least `amount`.\n */\n function _transfer(address from, address to, uint256 amount) internal virtual {\n require(from != address(0), \"ERC20: transfer from the zero address\");\n require(to != address(0), \"ERC20: transfer to the zero address\");\n\n _beforeTokenTransfer(from, to, amount);\n\n uint256 fromBalance = _balances[from];\n require(fromBalance >= amount, \"ERC20: transfer amount exceeds balance\");\n unchecked {\n _balances[from] = fromBalance - amount;\n // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\n // decrementing then incrementing.\n _balances[to] += amount;\n }\n\n emit Transfer(from, to, amount);\n\n _afterTokenTransfer(from, to, amount);\n }\n\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\n * the total supply.\n *\n * Emits a {Transfer} event with `from` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n */\n function _mint(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: mint to the zero address\");\n\n _beforeTokenTransfer(address(0), account, amount);\n\n _totalSupply += amount;\n unchecked {\n // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\n _balances[account] += amount;\n }\n emit Transfer(address(0), account, amount);\n\n _afterTokenTransfer(address(0), account, amount);\n }\n\n /**\n * @dev Destroys `amount` tokens from `account`, reducing the\n * total supply.\n *\n * Emits a {Transfer} event with `to` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n * - `account` must have at least `amount` tokens.\n */\n function _burn(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: burn from the zero address\");\n\n _beforeTokenTransfer(account, address(0), amount);\n\n uint256 accountBalance = _balances[account];\n require(accountBalance >= amount, \"ERC20: burn amount exceeds balance\");\n unchecked {\n _balances[account] = accountBalance - amount;\n // Overflow not possible: amount <= accountBalance <= totalSupply.\n _totalSupply -= amount;\n }\n\n emit Transfer(account, address(0), amount);\n\n _afterTokenTransfer(account, address(0), amount);\n }\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\n *\n * This internal function is equivalent to `approve`, and can be used to\n * e.g. set automatic allowances for certain subsystems, etc.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `owner` cannot be the zero address.\n * - `spender` cannot be the zero address.\n */\n function _approve(address owner, address spender, uint256 amount) internal virtual {\n require(owner != address(0), \"ERC20: approve from the zero address\");\n require(spender != address(0), \"ERC20: approve to the zero address\");\n\n _allowances[owner][spender] = amount;\n emit Approval(owner, spender, amount);\n }\n\n /**\n * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\n *\n * Does not update the allowance amount in case of infinite allowance.\n * Revert if not enough allowance is available.\n *\n * Might emit an {Approval} event.\n */\n function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\n uint256 currentAllowance = allowance(owner, spender);\n if (currentAllowance != type(uint256).max) {\n require(currentAllowance >= amount, \"ERC20: insufficient allowance\");\n unchecked {\n _approve(owner, spender, currentAllowance - amount);\n }\n }\n }\n\n /**\n * @dev Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * will be transferred to `to`.\n * - when `from` is zero, `amount` tokens will be minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n\n /**\n * @dev Hook that is called after any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * has been transferred to `to`.\n * - when `from` is zero, `amount` tokens have been minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\n\n/**\n * @dev Interface for the optional metadata functions from the ERC20 standard.\n *\n * _Available since v4.1._\n */\ninterface IERC20Metadata is IERC20 {\n /**\n * @dev Returns the name of the token.\n */\n function name() external view returns (string memory);\n\n /**\n * @dev Returns the symbol of the token.\n */\n function symbol() external view returns (string memory);\n\n /**\n * @dev Returns the decimals places of the token.\n */\n function decimals() external view returns (uint8);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n */\ninterface IERC20Permit {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/IERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20Permit token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Address.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Context.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/ERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC165.sol\";\n\n/**\n * @dev Implementation of the {IERC165} interface.\n *\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\n * for the additional interface id that will be supported. For example:\n *\n * ```solidity\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\n * }\n * ```\n *\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\n */\nabstract contract ERC165 is IERC165 {\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IERC165).interfaceId;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/IERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC165 standard, as defined in the\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\n *\n * Implementers can declare support of contract interfaces, which can then be\n * queried by others ({ERC165Checker}).\n *\n * For an implementation, see {ERC165}.\n */\ninterface IERC165 {\n /**\n * @dev Returns true if this contract implements the interface defined by\n * `interfaceId`. See the corresponding\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\n * to learn more about how these ids are created.\n *\n * This function call must use less than 30 000 gas.\n */\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\n}\n" + }, + "@openzeppelin/contracts/utils/math/Math.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SignedMath.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Strings.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\";\n\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlledV8\n * @author Venus\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\n */\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\n /// @notice Access control manager contract\n IAccessControlManagerV8 private _accessControlManager;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n\n /// @notice Emitted when access control manager contract address is changed\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\n\n /// @notice Thrown when the action is prohibited by AccessControlManager\n error Unauthorized(address sender, address calledContract, string methodSignature);\n\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\n __Ownable2Step_init();\n __AccessControlled_init_unchained(accessControlManager_);\n }\n\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Sets the address of AccessControlManager\n * @dev Admin function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n * @custom:event Emits NewAccessControlManager event\n * @custom:access Only Governance\n */\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Returns the address of the access control manager contract\n */\n function accessControlManager() external view returns (IAccessControlManagerV8) {\n return _accessControlManager;\n }\n\n /**\n * @dev Internal function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n */\n function _setAccessControlManager(address accessControlManager_) internal {\n require(address(accessControlManager_) != address(0), \"invalid acess control manager address\");\n address oldAccessControlManager = address(_accessControlManager);\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\n }\n\n /**\n * @notice Reverts if the call is not allowed by AccessControlManager\n * @param signature Method signature\n */\n function _checkAccessAllowed(string memory signature) internal view {\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\n\n if (!isAllowedToCall) {\n revert Unauthorized(msg.sender, address(this), signature);\n }\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlManager\n * @author Venus\n * @dev This contract is a wrapper of OpenZeppelin AccessControl extending it in a way to standartize access control within Venus Smart Contract Ecosystem.\n * @notice Access control plays a crucial role in the Venus governance model. It is used to restrict functions so that they can only be called from one\n * account or list of accounts (EOA or Contract Accounts).\n *\n * The implementation of `AccessControlManager`(https://github.com/VenusProtocol/governance-contracts/blob/main/contracts/Governance/AccessControlManager.sol)\n * inherits the [Open Zeppelin AccessControl](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/AccessControl.sol)\n * contract as a base for role management logic. There are two role types: admin and granular permissions.\n * \n * ## Granular Roles\n * \n * Granular roles are built by hashing the contract address and its function signature. For example, given contract `Foo` with function `Foo.bar()` which\n * is guarded by ACM, calling `giveRolePermission` for account B do the following:\n * \n * 1. Compute `keccak256(contractFooAddress,functionSignatureBar)`\n * 1. Add the computed role to the roles of account B\n * 1. Account B now can call `ContractFoo.bar()`\n * \n * ## Admin Roles\n * \n * Admin roles allow for an address to call a function signature on any contract guarded by the `AccessControlManager`. This is particularly useful for\n * contracts created by factories.\n * \n * For Admin roles a null address is hashed in place of the contract address (`keccak256(0x0000000000000000000000000000000000000000,functionSignatureBar)`.\n * \n * In the previous example, giving account B the admin role, account B will have permissions to call the `bar()` function on any contract that is guarded by\n * ACM, not only contract A.\n * \n * ## Protocol Integration\n * \n * All restricted functions in Venus Protocol use a hook to ACM in order to check if the caller has the right permission to call the guarded function.\n * `AccessControlledV5` and `AccessControlledV8` abstract contract makes this integration easier. They call ACM's external method\n * `isAllowedToCall(address caller, string functionSig)`. Here is an example of how `setCollateralFactor` function in `Comptroller` is integrated with ACM:\n\n```\n contract Comptroller is [...] AccessControlledV8 {\n [...]\n function setCollateralFactor(VToken vToken, uint256 newCollateralFactorMantissa, uint256 newLiquidationThresholdMantissa) external {\n _checkAccessAllowed(\"setCollateralFactor(address,uint256,uint256)\");\n [...]\n }\n }\n```\n */\ncontract AccessControlManager is AccessControl, IAccessControlManagerV8 {\n /// @notice Emitted when an account is given a permission to a certain contract function\n /// @dev If contract address is 0x000..0 this means that the account is a default admin of this function and\n /// can call any contract function with this signature\n event PermissionGranted(address account, address contractAddress, string functionSig);\n\n /// @notice Emitted when an account is revoked a permission to a certain contract function\n event PermissionRevoked(address account, address contractAddress, string functionSig);\n\n constructor() {\n // Grant the contract deployer the default admin role: it will be able\n // to grant and revoke any roles\n _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);\n }\n\n /**\n * @notice Gives a function call permission to one single account\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * @param contractAddress address of contract for which call permissions will be granted\n * @dev if contractAddress is zero address, the account can access the specified function\n * on **any** contract managed by this ACL\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @param accountToPermit account that will be given access to the contract function\n * @custom:event Emits a {RoleGranted} and {PermissionGranted} events.\n */\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n grantRole(role, accountToPermit);\n emit PermissionGranted(accountToPermit, contractAddress, functionSig);\n }\n\n /**\n * @notice Revokes an account's permission to a particular function call\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * \t\tMay emit a {RoleRevoked} event.\n * @param contractAddress address of contract for which call permissions will be revoked\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @custom:event Emits {RoleRevoked} and {PermissionRevoked} events.\n */\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n revokeRole(role, accountToRevoke);\n emit PermissionRevoked(accountToRevoke, contractAddress, functionSig);\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev Since restricted contracts using this function as a permission hook, we can get contracts address with msg.sender\n * @param account for which call permissions will be checked\n * @param functionSig restricted function signature e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n *\n */\n function isAllowedToCall(address account, string calldata functionSig) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(msg.sender, functionSig));\n\n if (hasRole(role, account)) {\n return true;\n } else {\n role = keccak256(abi.encodePacked(address(0), functionSig));\n return hasRole(role, account);\n }\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev This function is used as a view function to check permissions rather than contract hook for access restriction check.\n * @param account for which call permissions will be checked against\n * @param contractAddress address of the restricted contract\n * @param functionSig signature of the restricted function e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n */\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n return hasRole(role, account);\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport \"@openzeppelin/contracts/access/IAccessControl.sol\";\n\n/**\n * @title IAccessControlManagerV8\n * @author Venus\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\n */\ninterface IAccessControlManagerV8 is IAccessControl {\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\n\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) external;\n\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\n\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) external view returns (bool);\n}\n" + }, + "@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\ninterface OracleInterface {\n function getPrice(address asset) external view returns (uint256);\n}\n\ninterface ResilientOracleInterface is OracleInterface {\n function updatePrice(address vToken) external;\n\n function updateAssetPrice(address asset) external;\n\n function getUnderlyingPrice(address vToken) external view returns (uint256);\n}\n\ninterface TwapInterface is OracleInterface {\n function updateTwap(address asset) external returns (uint256);\n}\n\ninterface BoundValidatorInterface {\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool);\n}\n" + }, + "@venusprotocol/solidity-utilities/contracts/constants.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\nuint256 constant EXP_SCALE = 1e18;\n\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\nuint256 constant MANTISSA_ONE = EXP_SCALE;\n" + }, + "@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \"./constants.sol\";\n\n/**\n * @title Exponential module for storing fixed-precision decimals\n * @author Compound\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\n * `Exp({mantissa: 5100000000000000000})`.\n */\ncontract ExponentialNoError {\n struct Exp {\n uint256 mantissa;\n }\n\n struct Double {\n uint256 mantissa;\n }\n\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\n uint256 internal constant DOUBLE_SCALE = 1e36;\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\n\n /**\n * @dev Truncates the given exp to a whole number value.\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\n */\n function truncate(Exp memory exp) internal pure returns (uint256) {\n // Note: We are not using careful math here as we're performing a division that cannot fail\n return exp.mantissa / EXP_SCALE;\n }\n\n /**\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return truncate(product);\n }\n\n /**\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return add_(truncate(product), addend);\n }\n\n /**\n * @dev Checks if first Exp is less than second Exp.\n */\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\n return left.mantissa < right.mantissa;\n }\n\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\n require(n <= type(uint224).max, errorMessage);\n return uint224(n);\n }\n\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\n require(n <= type(uint32).max, errorMessage);\n return uint32(n);\n }\n\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a + b;\n }\n\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a - b;\n }\n\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\n }\n\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / EXP_SCALE;\n }\n\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\n }\n\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\n }\n\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a * b;\n }\n\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\n }\n\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return div_(mul_(a, EXP_SCALE), b.mantissa);\n }\n\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\n }\n\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\n }\n\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a / b;\n }\n\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\n }\n}\n" + }, + "@venusprotocol/solidity-utilities/contracts/validators.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\nerror ZeroAddressNotAllowed();\n\n/// @notice Checks if the provided address is nonzero, reverts otherwise\n/// @param address_ Address to check\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\nfunction ensureNonzeroAddress(address address_) pure {\n if (address_ == address(0)) {\n revert ZeroAddressNotAllowed();\n }\n}\n" + }, + "contracts/Bridge/BaseXVSProxyOFT.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ResilientOracleInterface } from \"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { BaseOFTV2 } from \"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { ExponentialNoError } from \"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\";\n\n/**\n * @title BaseXVSProxyOFT\n * @author Venus\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\n * It manages transaction limits of a single and daily transactions.\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\n */\n\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\n using SafeERC20 for IERC20;\n IERC20 internal immutable innerToken;\n uint256 internal immutable ld2sdRate;\n bool public sendAndCallEnabled;\n\n /**\n * @notice The address of ResilientOracle contract wrapped in its interface.\n */\n ResilientOracleInterface public oracle;\n /**\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\n /**\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\n /**\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\n /**\n * @notice Timestamp when the last 24-hour window started from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\n /**\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\n /**\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\n /**\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\n /**\n * @notice Timestamp when the last 24-hour window started from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\n /**\n * @notice Address on which cap check and bound limit is not applicable.\n */\n mapping(address => bool) public whitelist;\n\n /**\n * @notice Emitted when address is added to whitelist.\n */\n event SetWhitelist(address indexed addr, bool isWhitelist);\n /**\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\n */\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\n */\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\n */\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\n */\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Event emitted when oracle is modified.\n */\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\n /**\n * @notice Event emitted when trusted remote sets to empty.\n */\n event TrustedRemoteRemoved(uint16 chainId);\n /**\n * @notice Event emitted when inner token set successfully.\n */\n event InnerTokenAdded(address indexed innerToken);\n /**\n *@notice Emitted on sweep token success\n */\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\n /**\n * @notice Event emitted when SendAndCallEnabled updated successfully.\n */\n event UpdateSendAndCallEnabled(bool indexed enabled);\n /**\n *@notice Error thrown when this contract balance is less than sweep amount\n */\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\n\n /**\n * @param tokenAddress_ Address of the inner token.\n * @param sharedDecimals_ Number of shared decimals.\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\n * @param oracle_ Address of the price oracle.\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\n * @custom:event Emits InnerTokenAdded with token address.\n * @custom:event Emits OracleChanged with zero address and oracle address.\n */\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\n ensureNonzeroAddress(tokenAddress_);\n ensureNonzeroAddress(lzEndpoint_);\n ensureNonzeroAddress(oracle_);\n\n innerToken = IERC20(tokenAddress_);\n\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\"decimals()\"));\n require(success, \"ProxyOFT: failed to get token decimals\");\n uint8 decimals = abi.decode(data, (uint8));\n\n require(sharedDecimals_ <= decimals, \"ProxyOFT: sharedDecimals must be <= decimals\");\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\n\n emit InnerTokenAdded(tokenAddress_);\n emit OracleChanged(address(0), oracle_);\n\n oracle = ResilientOracleInterface(oracle_);\n }\n\n /**\n * @notice Set the address of the ResilientOracle contract.\n * @dev Reverts if the new address is zero.\n * @param oracleAddress_ The new address of the ResilientOracle contract.\n * @custom:access Only owner.\n * @custom:event Emits OracleChanged with old and new oracle address.\n */\n function setOracle(address oracleAddress_) external onlyOwner {\n ensureNonzeroAddress(oracleAddress_);\n emit OracleChanged(address(oracle), oracleAddress_);\n oracle = ResilientOracleInterface(oracleAddress_);\n }\n\n /**\n * @notice Sets the limit of single transaction amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \"Single transaction limit > Daily limit\");\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the limit of daily (24 Hour) transactions amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\n */\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \"Daily limit < single transaction limit\");\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\n chainIdToMaxDailyLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum limit for a single receive transaction.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \"single receive transaction limit > Daily limit\");\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum daily limit for receiving transactions.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\n */\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\n \"Daily limit < single receive transaction limit\"\n );\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the whitelist address to skip checks on transaction limit.\n * @param user_ Address to be add in whitelist.\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\n * @custom:access Only owner.\n * @custom:event Emits setWhitelist.\n */\n function setWhitelist(address user_, bool val_) external onlyOwner {\n emit SetWhitelist(user_, val_);\n whitelist[user_] = val_;\n }\n\n /**\n * @notice Triggers stopped state of the bridge.\n * @custom:access Only owner.\n */\n function pause() external onlyOwner {\n _pause();\n }\n\n /**\n * @notice Triggers resume state of the bridge.\n * @custom:access Only owner.\n */\n function unpause() external onlyOwner {\n _unpause();\n }\n\n /**\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\n * @param token_ The address of the ERC-20 token to sweep\n * @param to_ The address of the recipient\n * @param amount_ The amount of tokens needs to transfer\n * @custom:event Emits SweepToken event\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\n * @custom:access Only Owner\n */\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\n uint256 balance = token_.balanceOf(address(this));\n if (amount_ > balance) {\n revert InsufficientBalance(amount_, balance);\n }\n\n emit SweepToken(address(token_), to_, amount_);\n\n token_.safeTransfer(to_, amount_);\n }\n\n /**\n * @notice Remove trusted remote from storage.\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\n * @custom:access Only owner.\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\n */\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\n delete trustedRemoteLookup[remoteChainId_];\n emit TrustedRemoteRemoved(remoteChainId_);\n }\n\n /**\n * @notice It enables or disables sendAndCall functionality for the bridge.\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\n */\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\n sendAndCallEnabled = enabled_;\n emit UpdateSendAndCallEnabled(enabled_);\n }\n\n /**\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\n * @param from_ The sender's address initiating the transfer.\n * @param dstChainId_ Indicates destination chain.\n * @param amount_ The quantity of tokens to be transferred.\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\n * @return maxDailyLimit The maximum daily limit for transactions.\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\n */\n function isEligibleToSend(\n address from_,\n uint16 dstChainId_,\n uint256 amount_\n )\n external\n view\n returns (\n bool eligibleToSend,\n uint256 maxSingleTransactionLimit,\n uint256 maxDailyLimit,\n uint256 amountInUsd,\n uint256 transferredInWindow,\n uint256 last24HourWindowStart,\n bool isWhiteListedUser\n )\n {\n // Check if the sender's address is whitelisted\n isWhiteListedUser = whitelist[from_];\n\n // Calculate the amount in USD using the oracle price\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n last24HourWindowStart = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n eligibleToSend = (isWhiteListedUser ||\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\n }\n\n /**\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\n * @param from_ Address from which tokens will be debited.\n * @param dstChainId_ Destination chain id on which tokens will be send.\n * @param toAddress_ Address on which tokens will be credited on destination chain.\n * @param amount_ Amount of tokens that will be transferred.\n * @param payload_ Additional data payload for the call on the destination chain.\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\n * and adapter params.\n */\n function sendAndCall(\n address from_,\n uint16 dstChainId_,\n bytes32 toAddress_,\n uint256 amount_,\n bytes calldata payload_,\n uint64 dstGasForCall_,\n LzCallParams calldata callparams_\n ) public payable override {\n require(sendAndCallEnabled, \"sendAndCall is disabled\");\n\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\n }\n\n function retryMessage(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public payable override {\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\n require(\n _srcAddress.length == trustedRemote.length &&\n trustedRemote.length > 0 &&\n keccak256(_srcAddress) == keccak256(trustedRemote),\n \"LzApp: invalid source sending contract\"\n );\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @notice Return's the address of the inner token of this bridge.\n * @return Address of the inner token of this bridge.\n */\n function token() public view override returns (address) {\n return address(innerToken);\n }\n\n /**\n * @notice Checks if the sender is eligible to send tokens\n * @param from_ Sender's address sending tokens\n * @param dstChainId_ Chain id on which tokens should be sent\n * @param amount_ Amount of tokens to be sent\n */\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\n // Check if the sender's address is whitelisted\n bool isWhiteListedUser = whitelist[from_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the amount in USD using the oracle price\n uint256 amountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n\n // Revert if the amount exceeds the single transaction limit\n require(amountInUsd <= maxSingleTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n\n // Revert if the amount exceeds the daily limit\n require(transferredInWindow <= maxDailyLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the amount for the 24-hour window\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\n }\n\n /**\n * @notice Checks if receiver is able to receive tokens\n * @param toAddress_ Receiver address\n * @param srcChainId_ Source chain id from which token is send\n * @param receivedAmount_ Amount of tokens received\n */\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\n // Check if the recipient's address is whitelisted\n bool isWhiteListedUser = whitelist[toAddress_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the received amount in USD using the oracle price\n uint256 receivedAmountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\n\n uint256 currentBlockTimestamp = block.timestamp;\n\n // Load values for the 24-hour window checks for receiving\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\n\n // Check if the received amount exceeds the single transaction limit\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\n receivedInWindow = receivedAmountInUsd;\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\n } else {\n receivedInWindow += receivedAmountInUsd;\n }\n\n // Revert if the received amount exceeds the daily limit\n require(receivedInWindow <= maxDailyReceiveLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the received amount for the 24-hour window\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\n }\n\n /**\n * @notice Transfer tokens from sender to receiver account.\n * @param from_ Address from which token has to be transferred(Sender).\n * @param to_ Address on which token will be tranferred(Receiver).\n * @param amount_ Amount of token to be transferred.\n * @return Actual balance difference.\n */\n function _transferFrom(\n address from_,\n address to_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n uint256 before = innerToken.balanceOf(to_);\n if (from_ == address(this)) {\n innerToken.safeTransfer(to_, amount_);\n } else {\n innerToken.safeTransferFrom(from_, to_, amount_);\n }\n return innerToken.balanceOf(to_) - before;\n }\n\n /**\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\n * @return Conversion rate factor.\n */\n function _ld2sdRate() internal view override returns (uint256) {\n return ld2sdRate;\n }\n}\n" + }, + "contracts/Bridge/interfaces/IXVS.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/**\n * @title IXVS\n * @author Venus\n * @notice Interface implemented by `XVS` token.\n */\ninterface IXVS {\n function mint(address to, uint256 amount) external;\n\n function burn(address from, uint256 amount) external;\n}\n" + }, + "contracts/Bridge/interfaces/IXVSProxyOFT.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/**\n * @title IXVSProxyOFT\n * @author Venus\n * @notice Interface implemented by `XVSProxyOFT`.\n */\ninterface IXVSProxyOFT {\n function transferOwnership(address addr) external;\n\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\n\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\n}\n" + }, + "contracts/Bridge/token/TokenController.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\nimport { IAccessControlManagerV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { Ownable } from \"@openzeppelin/contracts/access/Ownable.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title TokenController\n * @author Venus\n * @notice TokenController contract acts as a governance and access control mechanism,\n * allowing the owner to manage minting restrictions and blacklist certain addresses to maintain control and security within the token ecosystem.\n * It provides a flexible framework for token-related operations.\n */\n\ncontract TokenController is Ownable, Pausable {\n /**\n * @notice Access control manager contract address.\n */\n address public accessControlManager;\n /**\n * @notice A Mapping used to keep track of the blacklist status of addresses.\n */\n mapping(address => bool) internal _blacklist;\n /**\n * @notice A mapping is used to keep track of the maximum amount a minter is permitted to mint.\n */\n mapping(address => uint256) public minterToCap;\n /**\n * @notice A Mapping used to keep track of the amount i.e already minted by minter.\n */\n mapping(address => uint256) public minterToMintedAmount;\n\n /**\n * @notice Emitted when the blacklist status of a user is updated.\n */\n event BlacklistUpdated(address indexed user, bool value);\n /**\n * @notice Emitted when the minting limit for a minter is increased.\n */\n event MintLimitIncreased(address indexed minter, uint256 newLimit);\n /**\n * @notice Emitted when the minting limit for a minter is decreased.\n */\n event MintLimitDecreased(address indexed minter, uint256 newLimit);\n /**\n * @notice Emitted when the minting cap for a minter is changed.\n */\n event MintCapChanged(address indexed minter, uint256 amount);\n /**\n * @notice Emitted when the address of the access control manager of the contract is updated.\n */\n event NewAccessControlManager(address indexed oldAccessControlManager, address indexed newAccessControlManager);\n /**\n * @notice Emitted when all minted tokens are migrated from one minter to another.\n */\n event MintedTokensMigrated(address indexed source, address indexed destination);\n\n /**\n * @notice This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\n */\n error MintLimitExceed();\n /**\n * @notice This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\n */\n error AccountBlacklisted(address user);\n /**\n * @notice This error is used to indicate that sender is not allowed to perform this action.\n */\n error Unauthorized();\n /**\n * @notice This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\n */\n error NewCapNotGreaterThanMintedTokens();\n /**\n * @notice This error is used to indicate that the addresses must be different.\n */\n error AddressesMustDiffer();\n /**\n * @notice This error is used to indicate that the minter did not mint the required amount of tokens.\n */\n error MintedAmountExceed();\n\n /**\n * @param accessControlManager_ Address of access control manager contract.\n * @custom:error ZeroAddressNotAllowed is thrown when accessControlManager contract address is zero.\n */\n constructor(address accessControlManager_) {\n ensureNonzeroAddress(accessControlManager_);\n accessControlManager = accessControlManager_;\n }\n\n /**\n * @notice Pauses Token\n * @custom:access Controlled by AccessControlManager.\n */\n function pause() external {\n _ensureAllowed(\"pause()\");\n _pause();\n }\n\n /**\n * @notice Resumes Token\n * @custom:access Controlled by AccessControlManager.\n */\n function unpause() external {\n _ensureAllowed(\"unpause()\");\n _unpause();\n }\n\n /**\n * @notice Function to update blacklist.\n * @param user_ User address to be affected.\n * @param value_ Boolean to toggle value.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits BlacklistUpdated event.\n */\n function updateBlacklist(address user_, bool value_) external {\n _ensureAllowed(\"updateBlacklist(address,bool)\");\n _blacklist[user_] = value_;\n emit BlacklistUpdated(user_, value_);\n }\n\n /**\n * @notice Sets the minting cap for minter.\n * @param minter_ Minter address.\n * @param amount_ Cap for the minter.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintCapChanged.\n */\n function setMintCap(address minter_, uint256 amount_) external {\n _ensureAllowed(\"setMintCap(address,uint256)\");\n\n if (amount_ < minterToMintedAmount[minter_]) {\n revert NewCapNotGreaterThanMintedTokens();\n }\n\n minterToCap[minter_] = amount_;\n emit MintCapChanged(minter_, amount_);\n }\n\n /**\n * @notice Sets the address of the access control manager of this contract.\n * @dev Admin function to set the access control address.\n * @param newAccessControlAddress_ New address for the access control.\n * @custom:access Only owner.\n * @custom:event Emits NewAccessControlManager.\n * @custom:error ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\n */\n function setAccessControlManager(address newAccessControlAddress_) external onlyOwner {\n ensureNonzeroAddress(newAccessControlAddress_);\n emit NewAccessControlManager(accessControlManager, newAccessControlAddress_);\n accessControlManager = newAccessControlAddress_;\n }\n\n /**\n * @notice Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\n * @param source_ Minter address to migrate tokens from.\n * @param destination_ Minter address to migrate tokens to.\n * @custom:access Controlled by AccessControlManager.\n * @custom:error MintLimitExceed is thrown when the minting limit exceeds the cap after migration.\n * @custom:error AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\n * @custom:event Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.\n * @custom:event Emits MintedTokensMigrated.\n */\n function migrateMinterTokens(address source_, address destination_) external {\n _ensureAllowed(\"migrateMinterTokens(address,address)\");\n\n if (source_ == destination_) {\n revert AddressesMustDiffer();\n }\n\n uint256 sourceCap = minterToCap[source_];\n uint256 destinationCap = minterToCap[destination_];\n\n uint256 sourceMinted = minterToMintedAmount[source_];\n uint256 destinationMinted = minterToMintedAmount[destination_];\n uint256 newDestinationMinted = destinationMinted + sourceMinted;\n\n if (newDestinationMinted > destinationCap) {\n revert MintLimitExceed();\n }\n\n minterToMintedAmount[source_] = 0;\n minterToMintedAmount[destination_] = newDestinationMinted;\n uint256 availableLimit;\n unchecked {\n availableLimit = destinationCap - newDestinationMinted;\n }\n\n emit MintLimitDecreased(destination_, availableLimit);\n emit MintLimitIncreased(source_, sourceCap);\n emit MintedTokensMigrated(source_, destination_);\n }\n\n /**\n * @notice Returns the blacklist status of the address.\n * @param user_ Address of user to check blacklist status.\n * @return bool status of blacklist.\n */\n function isBlackListed(address user_) external view returns (bool) {\n return _blacklist[user_];\n }\n\n /**\n * @dev Checks the minter cap and eligibility of receiver to receive tokens.\n * @param from_ Minter address.\n * @param to_ Receiver address.\n * @param amount_ Amount to be mint.\n * @custom:error MintLimitExceed is thrown when minting limit exceeds the cap.\n * @custom:event Emits MintLimitDecreased with minter address and available limits.\n */\n function _isEligibleToMint(address from_, address to_, uint256 amount_) internal {\n uint256 mintingCap = minterToCap[from_];\n uint256 totalMintedOld = minterToMintedAmount[from_];\n uint256 totalMintedNew = totalMintedOld + amount_;\n\n if (totalMintedNew > mintingCap) {\n revert MintLimitExceed();\n }\n minterToMintedAmount[from_] = totalMintedNew;\n uint256 availableLimit;\n unchecked {\n availableLimit = mintingCap - totalMintedNew;\n }\n emit MintLimitDecreased(from_, availableLimit);\n }\n\n /**\n * @dev This is post hook of burn function, increases minting limit of the minter.\n * @param from_ Minter address.\n * @param amount_ Amount burned.\n * @custom:error MintedAmountExceed is thrown when `amount_` is greater than the tokens minted by `from_`.\n * @custom:event Emits MintLimitIncreased with minter address and availabe limit.\n */\n function _increaseMintLimit(address from_, uint256 amount_) internal {\n uint256 totalMintedOld = minterToMintedAmount[from_];\n\n if (totalMintedOld < amount_) {\n revert MintedAmountExceed();\n }\n\n uint256 totalMintedNew;\n unchecked {\n totalMintedNew = totalMintedOld - amount_;\n }\n minterToMintedAmount[from_] = totalMintedNew;\n uint256 availableLimit = minterToCap[from_] - totalMintedNew;\n emit MintLimitIncreased(from_, availableLimit);\n }\n\n /**\n * @dev Checks the caller is allowed to call the specified fuction.\n * @param functionSig_ Function signatureon which access is to be checked.\n * @custom:error Unauthorized, thrown when unauthorised user try to access function.\n */\n function _ensureAllowed(string memory functionSig_) internal view {\n if (!IAccessControlManagerV8(accessControlManager).isAllowedToCall(msg.sender, functionSig_)) {\n revert Unauthorized();\n }\n }\n}\n" + }, + "contracts/Bridge/token/XVS.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\nimport { TokenController } from \"./TokenController.sol\";\n\n/**\n * @title XVS\n * @author Venus\n * @notice XVS contract serves as a customized ERC-20 token with additional minting and burning functionality.\n * It also incorporates access control features provided by the \"TokenController\" contract to ensure proper governance and restrictions on minting and burning operations.\n */\n\ncontract XVS is ERC20, TokenController {\n constructor(address accessControlManager_) ERC20(\"Venus XVS\", \"XVS\") TokenController(accessControlManager_) {}\n\n /**\n * @notice Creates `amount_` tokens and assigns them to `account_`, increasing\n * the total supply. Checks access and eligibility.\n * @param account_ Address to which tokens are assigned.\n * @param amount_ Amount of tokens to be assigned.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintLimitDecreased with new available limit.\n * @custom:error MintLimitExceed is thrown when minting amount exceeds the maximum cap.\n */\n function mint(address account_, uint256 amount_) external whenNotPaused {\n _ensureAllowed(\"mint(address,uint256)\");\n _isEligibleToMint(msg.sender, account_, amount_);\n _mint(account_, amount_);\n }\n\n /**\n * @notice Destroys `amount_` tokens from `account_`, reducing the\n * total supply. Checks access and eligibility.\n * @param account_ Address from which tokens be destroyed.\n * @param amount_ Amount of tokens to be destroyed.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintLimitIncreased with new available limit.\n */\n function burn(address account_, uint256 amount_) external whenNotPaused {\n _ensureAllowed(\"burn(address,uint256)\");\n _burn(account_, amount_);\n _increaseMintLimit(msg.sender, amount_);\n }\n\n /**\n * @notice Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n * @param from_ Address of account from which tokens are to be transferred.\n * @param to_ Address of the account to which tokens are to be transferred.\n * @param amount_ The amount of tokens to be transferred.\n * @custom:error AccountBlacklisted is thrown when either `from` or `to` address is blacklisted.\n */\n function _beforeTokenTransfer(address from_, address to_, uint256 amount_) internal override whenNotPaused {\n if (_blacklist[to_]) {\n revert AccountBlacklisted(to_);\n }\n if (_blacklist[from_]) {\n revert AccountBlacklisted(from_);\n }\n }\n}\n" + }, + "contracts/Bridge/XVSBridgeAdmin.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n\npragma solidity 0.8.13;\n\nimport { AccessControlledV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { IXVSProxyOFT } from \"./interfaces/IXVSProxyOFT.sol\";\n\n/**\n * @title XVSBridgeAdmin\n * @author Venus\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\n * It maintains a registry of function signatures and names,\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\n */\ncontract XVSBridgeAdmin is AccessControlledV8 {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IXVSProxyOFT public immutable XVSBridge;\n /**\n * @notice A mapping keeps track of function signature associated with function name string.\n */\n mapping(bytes4 => string) public functionRegistry;\n\n /**\n * @notice emitted when function registry updated\n */\n event FunctionRegistryChanged(string signature, bool active);\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address XVSBridge_) {\n ensureNonzeroAddress(XVSBridge_);\n XVSBridge = IXVSProxyOFT(XVSBridge_);\n _disableInitializers();\n }\n\n /**\n * @param accessControlManager_ Address of access control manager contract.\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Invoked when called function does not exist in the contract.\n * @return Response of low level call.\n * @custom:access Controlled by AccessControlManager.\n */\n fallback(bytes calldata data) external returns (bytes memory) {\n string memory fun = _getFunctionName(msg.sig);\n require(bytes(fun).length != 0, \"Function not found\");\n _checkAccessAllowed(fun);\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\n require(ok, \"call failed\");\n return res;\n }\n\n /**\n * @notice Sets trusted remote on particular chain.\n * @param remoteChainId_ Chain Id of the destination chain.\n * @param remoteAddress_ Address of the destination bridge.\n * @custom:access Controlled by AccessControlManager.\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\n */\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\n _checkAccessAllowed(\"setTrustedRemoteAddress(uint16,bytes)\");\n require(remoteChainId_ != 0, \"ChainId must not be zero\");\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\n }\n\n /**\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\n * @param signatures_ Function signature to be added or removed.\n * @param active_ bool value, should be true to add function.\n * @custom:access Only owner.\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\n */\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\n uint256 signatureLength = signatures_.length;\n require(signatureLength == active_.length, \"Input arrays must have the same length\");\n for (uint256 i; i < signatureLength; ) {\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\n bytes memory signature = bytes(functionRegistry[sigHash]);\n if (active_[i] && signature.length == 0) {\n functionRegistry[sigHash] = signatures_[i];\n emit FunctionRegistryChanged(signatures_[i], true);\n } else if (!active_[i] && signature.length != 0) {\n delete functionRegistry[sigHash];\n emit FunctionRegistryChanged(signatures_[i], false);\n }\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\n * @param newOwner_ New owner of the XVS Bridge.\n * @custom:access Controlled by AccessControlManager.\n */\n function transferBridgeOwnership(address newOwner_) external {\n _checkAccessAllowed(\"transferBridgeOwnership(address)\");\n XVSBridge.transferOwnership(newOwner_);\n }\n\n /**\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\n * @param remoteChainId_ Chain Id of the destination chain.\n * @param remoteAddress_ Address of the destination bridge.\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\n * @return Bool indicating whether the remote chain is trusted or not.\n */\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\n require(remoteChainId_ != 0, \"ChainId must not be zero\");\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @dev Returns function name string associated with function signature.\n * @param signature_ Four bytes of function signature.\n * @return Function signature corresponding to its hash.\n */\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\n return functionRegistry[signature_];\n }\n\n /**\n * @notice Converts given bytes into address.\n * @param b Bytes to be converted into address.\n * @return Converted address of given bytes.\n */\n function bytesToAddress(bytes calldata b) private pure returns (address) {\n return address(uint160(bytes20(b)));\n }\n}\n" + }, + "contracts/Bridge/XVSProxyOFTDest.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { IXVS } from \"./interfaces/IXVS.sol\";\nimport { BaseXVSProxyOFT } from \"./BaseXVSProxyOFT.sol\";\n\n/**\n * @title XVSProxyOFTDest\n * @author Venus\n * @notice XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT,\n * and focuses on managing token transfers to the destination chain.\n * It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\n */\n\ncontract XVSProxyOFTDest is BaseXVSProxyOFT {\n /**\n * @notice Emits when stored message dropped without successful retrying.\n */\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\n\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\n\n /**\n * @notice Clear failed messages from the storage.\n * @param srcChainId_ Chain id of source\n * @param srcAddress_ Address of source followed by current bridge address\n * @param nonce_ Nonce_ of the transaction\n * @custom:access Only owner\n * @custom:event Emits DropFailedMessage on clearance of failed message.\n */\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\n }\n\n /**\n * @notice Returns the total circulating supply of the token on the destination chain i.e (total supply).\n * @return total circulating supply of the token on the destination chain.\n */\n function circulatingSupply() public view override returns (uint256) {\n return innerToken.totalSupply();\n }\n\n /**\n * @notice Debit tokens from the given address\n * @param from_ Address from which tokens to be debited\n * @param dstChainId_ Destination chain id\n * @param amount_ Amount of tokens to be debited\n * @return Actual amount debited\n */\n function _debitFrom(\n address from_,\n uint16 dstChainId_,\n bytes32,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n require(from_ == _msgSender(), \"ProxyOFT: owner is not send caller\");\n _isEligibleToSend(from_, dstChainId_, amount_);\n IXVS(address(innerToken)).burn(from_, amount_);\n return amount_;\n }\n\n /**\n * @notice Credit tokens in the given account\n * @param srcChainId_ Source chain id\n * @param toAddress_ Address on which token will be credited\n * @param amount_ Amount of tokens to be credited\n * @return Actual amount credited\n */\n function _creditTo(\n uint16 srcChainId_,\n address toAddress_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\n IXVS(address(innerToken)).mint(toAddress_, amount_);\n return amount_;\n }\n}\n" + }, + "contracts/Bridge/XVSProxyOFTSrc.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BaseXVSProxyOFT } from \"./BaseXVSProxyOFT.sol\";\n\n/**\n * @title XVSProxyOFTSrc\n * @author Venus\n * @notice XVSProxyOFTSrc contract serves as a crucial component for cross-chain token transactions,\n * focusing on the source side of these transactions.\n * It monitors the total amount transferred to other chains, ensuring it complies with defined limits,\n * and provides functions for transferring tokens while maintaining control over the circulating supply on the source chain.\n */\n\ncontract XVSProxyOFTSrc is BaseXVSProxyOFT {\n using SafeERC20 for IERC20;\n /**\n * @notice Total amount that is transferred from this chain to other chains.\n */\n uint256 public outboundAmount;\n\n /**\n * @notice Emits when locked token released manually by owner.\n */\n event FallbackWithdraw(address indexed to, uint256 amount);\n /**\n * @notice Emits when stored message dropped without successful retrying.\n */\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\n /**\n * @notice Event emitted when tokens are forcefully locked.\n */\n event FallbackDeposit(address indexed from, uint256 amount_);\n\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\n\n /**\n * @notice Only call it when there is no way to recover the failed message.\n * `dropFailedMessage` must be called first if transaction is from remote->local chain to avoid double spending.\n * @param to_ The address to withdraw to\n * @param amount_ The amount of withdrawal\n * @custom:access Only owner.\n * @custom:event Emits FallbackWithdraw, once done with transfer.\n */\n function fallbackWithdraw(address to_, uint256 amount_) external onlyOwner {\n require(outboundAmount >= amount_, \"Withdraw amount should be less than outbound amount\");\n unchecked {\n outboundAmount -= amount_;\n }\n _transferFrom(address(this), to_, amount_);\n emit FallbackWithdraw(to_, amount_);\n }\n\n /**\n * @notice Forces the lock of tokens by increasing outbound amount and transferring tokens from the sender to the contract.\n * @param amount_ The amount of tokens to lock.\n * @param depositor_ Address of the depositor.\n * @custom:access Only owner.\n * @custom:event Emits FallbackDeposit, once done with transfer.\n */\n function fallbackDeposit(address depositor_, uint256 amount_) external onlyOwner {\n (uint256 actualAmount, ) = _removeDust(amount_);\n\n outboundAmount += actualAmount;\n uint256 cap = _sd2ld(type(uint64).max);\n require(cap >= outboundAmount, \"ProxyOFT: outboundAmount overflow\");\n\n _transferFrom(depositor_, address(this), actualAmount);\n\n emit FallbackDeposit(depositor_, actualAmount);\n }\n\n /**\n * @notice Clear failed messages from the storage.\n * @param srcChainId_ Chain id of source\n * @param srcAddress_ Address of source followed by current bridge address\n * @param nonce_ Nonce_ of the transaction\n * @custom:access Only owner.\n * @custom:event Emits DropFailedMessage on clearance of failed message.\n */\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\n }\n\n /**\n * @notice Returns the total circulating supply of the token on the source chain i.e (total supply - locked in this contract).\n * @return Returns difference in total supply and the outbound amount.\n */\n function circulatingSupply() public view override returns (uint256) {\n return innerToken.totalSupply() - outboundAmount;\n }\n\n /**\n * @notice Debit tokens from the given address\n * @param from_ Address from which tokens to be debited\n * @param dstChainId_ Destination chain id\n * @param amount_ Amount of tokens to be debited\n * @return Actual amount debited\n */\n function _debitFrom(\n address from_,\n uint16 dstChainId_,\n bytes32,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n require(from_ == _msgSender(), \"ProxyOFT: owner is not send caller\");\n _isEligibleToSend(from_, dstChainId_, amount_);\n\n uint256 amount = _transferFrom(from_, address(this), amount_);\n\n outboundAmount += amount;\n uint256 cap = _sd2ld(type(uint64).max);\n require(cap >= outboundAmount, \"ProxyOFT: outboundAmount overflow\");\n\n return amount;\n }\n\n /**\n * @notice Credit tokens in the given account\n * @param srcChainId_ Source chain id\n * @param toAddress_ Address on which token will be credited\n * @param amount_ Amount of tokens to be credited\n * @return Actual amount credited\n */\n function _creditTo(\n uint16 srcChainId_,\n address toAddress_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\n outboundAmount -= amount_;\n // tokens are already in this contract, so no need to transfer\n if (toAddress_ == address(this)) {\n return amount_;\n }\n\n return _transferFrom(address(this), toAddress_, amount_);\n }\n}\n" + }, + "contracts/test/MockToken.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { LZEndpointMock } from \"@layerzerolabs/solidity-examples/contracts/lzApp/mocks/LZEndpointMock.sol\";\nimport { AccessControlManager } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol\";\n\ncontract MockToken is ERC20 {\n uint8 private immutable _decimals;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function decimals() public view virtual override returns (uint8) {\n return _decimals;\n }\n}\n" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 200, + "details": { + "yul": true + } + }, + "outputSelection": { + "*": { + "*": [ + "storageLayout", + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "evm.gasEstimates" + ], + "": ["ast"] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} diff --git a/hardhat.config.ts b/hardhat.config.ts index 082044e..1ca68c0 100644 --- a/hardhat.config.ts +++ b/hardhat.config.ts @@ -139,6 +139,18 @@ const config: HardhatUserConfig = { mnemonic: process.env.MNEMONIC || "", }, }, + arbitrumsepolia: { + url: process.env.ARCHIVE_NODE_arbitrumsepolia || "https://sepolia-rollup.arbitrum.io/rpc", + chainId: 421614, + live: true, + accounts: DEPLOYER_PRIVATE_KEY ? [`0x${DEPLOYER_PRIVATE_KEY}`] : [], + }, + arbitrumone: { + url: process.env.ARCHIVE_NODE_arbitrumone || "https://arb1.arbitrum.io/rpc", + chainId: 42161, + live: true, + accounts: DEPLOYER_PRIVATE_KEY ? [`0x${DEPLOYER_PRIVATE_KEY}`] : [], + }, }, gasReporter: { enabled: process.env.REPORT_GAS !== undefined, @@ -194,6 +206,22 @@ const config: HardhatUserConfig = { browserURL: "https://opbnbscan.com/", }, }, + { + network: "arbitrumsepolia", + chainId: 421614, + urls: { + apiURL: `https://api-sepolia.arbiscan.io/api`, + browserURL: "https://sepolia.arbiscan.io/", + }, + }, + { + network: "arbitrumone", + chainId: 42161, + urls: { + apiURL: `https://api.arbiscan.io/api/`, + browserURL: "https://arbiscan.io/", + }, + }, ], apiKey: { bscmainnet: process.env.ETHERSCAN_API_KEY || "ETHERSCAN_API_KEY", @@ -202,6 +230,8 @@ const config: HardhatUserConfig = { ethereum: process.env.ETHERSCAN_API_KEY || "ETHERSCAN_API_KEY", opbnbtestnet: process.env.ETHERSCAN_API_KEY || "ETHERSCAN_API_KEY", opbnbmainnet: process.env.ETHERSCAN_API_KEY || "ETHERSCAN_API_KEY", + arbitrumsepolia: process.env.ETHERSCAN_API_KEY || "ETHERSCAN_API_KEY", + arbitrumone: process.env.ETHERSCAN_API_KEY || "ETHERSCAN_API_KEY", }, }, paths: { diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index 3f93d42..df311bd 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -10,6 +10,8 @@ const SEPOLIA_MULTISIG = "0x94fa6078b6b8a26f0b6edffbe6501b22a10470fb"; const OPBNB_TESTNET_MULTISIG = "0xb15f6EfEbC276A3b9805df81b5FB3D50C2A62BDf"; const OPBNB_MAINNET_MULTISIG = "0xC46796a21a3A9FAB6546aF3434F2eBfFd0604207"; const ETHEREUM_MULTISIG = "0x285960C5B22fD66A736C7136967A3eB15e93CC67"; +const ARBITRUM_SEPOLIA_MULTISIG = "0x1426A5Ae009c4443188DA8793751024E358A61C2"; +const ARBITRUM_ONE_MULTISIG = "0x14e0E151b33f9802b3e75b621c1457afc44DcAA0"; export const preconfiguredAddresses = { bsctestnet: { @@ -46,6 +48,20 @@ export const preconfiguredAddresses = { LzEndpoint: "0xb6319cC6c8c27A8F5dAF0dD3DF91EA35C4720dd7", LzVirtualChainId: "202", }, + arbitrumsepolia: { + NormalTimelock: ARBITRUM_SEPOLIA_MULTISIG, + FastTrackTimelock: ARBITRUM_SEPOLIA_MULTISIG, + CriticalTimelock: ARBITRUM_SEPOLIA_MULTISIG, + LzEndpoint: "0x6098e96a28E02f27B1e6BD381f870F1C8Bd169d3", + LzVirtualChainId: "10231", + }, + arbitrumone: { + NormalTimelock: ARBITRUM_ONE_MULTISIG, + FastTrackTimelock: ARBITRUM_ONE_MULTISIG, + CriticalTimelock: ARBITRUM_ONE_MULTISIG, + LzEndpoint: "0x3c2269811836af69497E5F486A85D7316753cf62", + LzVirtualChainId: "110", + }, }; export const xvsBridgeMethodsSrc = [ @@ -161,6 +177,24 @@ export const bridgeConfig: BridgeConfig = { { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, ], }, + arbitrumsepolia: { + methods: [ + { method: "setMinDstGas(uint16,uint16,uint256)", args: [10231, 0, "300000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [10231, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10231, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10231, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10231, "10000000000000000000000"] }, + ], + }, + arbitrumone: { + methods: [ + { method: "setMinDstGas(uint16,uint16,uint256)", args: [110, 0, "300000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [110, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [110, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [110, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [110, "10000000000000000000000"] }, + ], + }, }; export async function getPreConfiguredAddresses(networkName: string): Promise { @@ -177,6 +211,10 @@ export async function getPreConfiguredAddresses(networkName: string): Promise Date: Tue, 26 Mar 2024 10:15:33 +0000 Subject: [PATCH 02/17] feat: updating deployment files --- deployments/arbitrumone.json | 5 + deployments/arbitrumone_addresses.json | 5 + deployments/arbitrumsepolia.json | 3726 ++++++++++++++++++++ deployments/arbitrumsepolia_addresses.json | 12 + 4 files changed, 3748 insertions(+) create mode 100644 deployments/arbitrumone.json create mode 100644 deployments/arbitrumone_addresses.json create mode 100644 deployments/arbitrumsepolia.json create mode 100644 deployments/arbitrumsepolia_addresses.json diff --git a/deployments/arbitrumone.json b/deployments/arbitrumone.json new file mode 100644 index 0000000..4e3a56a --- /dev/null +++ b/deployments/arbitrumone.json @@ -0,0 +1,5 @@ +{ + "name": "arbitrumone", + "chainId": "42161", + "contracts": {} +} diff --git a/deployments/arbitrumone_addresses.json b/deployments/arbitrumone_addresses.json new file mode 100644 index 0000000..e65d709 --- /dev/null +++ b/deployments/arbitrumone_addresses.json @@ -0,0 +1,5 @@ +{ + "name": "arbitrumone", + "chainId": "42161", + "addresses": {} +} diff --git a/deployments/arbitrumsepolia.json b/deployments/arbitrumsepolia.json new file mode 100644 index 0000000..2951d2e --- /dev/null +++ b/deployments/arbitrumsepolia.json @@ -0,0 +1,3726 @@ +{ + "name": "arbitrumsepolia", + "chainId": "421614", + "contracts": { + "DefaultProxyAdmin": { + "address": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "initialOwner", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + }, + { + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "changeProxyAdmin", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + } + ], + "name": "getProxyAdmin", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + } + ], + "name": "getProxyImplementation", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + }, + { + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "upgrade", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract TransparentUpgradeableProxy", + "name": "proxy", + "type": "address" + }, + { + "internalType": "address", + "name": "implementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + } + ] + }, + "XVS": { + "address": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user", + "type": "address" + } + ], + "name": "AccountBlacklisted", + "type": "error" + }, + { + "inputs": [], + "name": "AddressesMustDiffer", + "type": "error" + }, + { + "inputs": [], + "name": "MintLimitExceed", + "type": "error" + }, + { + "inputs": [], + "name": "MintedAmountExceed", + "type": "error" + }, + { + "inputs": [], + "name": "NewCapNotGreaterThanMintedTokens", + "type": "error" + }, + { + "inputs": [], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "owner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "value", + "type": "uint256" + } + ], + "name": "Approval", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "user", + "type": "address" + }, + { + "indexed": false, + "internalType": "bool", + "name": "value", + "type": "bool" + } + ], + "name": "BlacklistUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "minter", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "MintCapChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "minter", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newLimit", + "type": "uint256" + } + ], + "name": "MintLimitDecreased", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "minter", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newLimit", + "type": "uint256" + } + ], + "name": "MintLimitIncreased", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "source", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "destination", + "type": "address" + } + ], + "name": "MintedTokensMigrated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Paused", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "from", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "value", + "type": "uint256" + } + ], + "name": "Transfer", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Unpaused", + "type": "event" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "owner", + "type": "address" + }, + { + "internalType": "address", + "name": "spender", + "type": "address" + } + ], + "name": "allowance", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "approve", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "balanceOf", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "burn", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "decimals", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "internalType": "uint256", + "name": "subtractedValue", + "type": "uint256" + } + ], + "name": "decreaseAllowance", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "spender", + "type": "address" + }, + { + "internalType": "uint256", + "name": "addedValue", + "type": "uint256" + } + ], + "name": "increaseAllowance", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user_", + "type": "address" + } + ], + "name": "isBlackListed", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "source_", + "type": "address" + }, + { + "internalType": "address", + "name": "destination_", + "type": "address" + } + ], + "name": "migrateMinterTokens", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "mint", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "name": "minterToCap", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "name": "minterToMintedAmount", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "name", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "paused", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newAccessControlAddress_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "minter_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "setMintCap", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "symbol", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "totalSupply", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "transfer", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "from", + "type": "address" + }, + { + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "transferFrom", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "unpause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user_", + "type": "address" + }, + { + "internalType": "bool", + "name": "value_", + "type": "bool" + } + ], + "name": "updateBlacklist", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ] + }, + "XVSBridgeAdmin": { + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "abi": [ + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "changeAdmin", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "string", + "name": "signature", + "type": "string" + }, + { + "indexed": false, + "internalType": "bool", + "name": "active", + "type": "bool" + } + ], + "name": "FunctionRegistryChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "XVSBridge", + "outputs": [ + { + "internalType": "contract IXVSProxyOFT", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bytes4", + "name": "", + "type": "bytes4" + } + ], + "name": "functionRegistry", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "isTrustedRemote", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "setTrustedRemoteAddress", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner_", + "type": "address" + } + ], + "name": "transferBridgeOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "string[]", + "name": "signatures_", + "type": "string[]" + }, + { + "internalType": "bool[]", + "name": "active_", + "type": "bool[]" + } + ], + "name": "upsertSignature", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + } + ] + }, + "XVSBridgeAdmin_Implementation": { + "address": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "XVSBridge_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "string", + "name": "signature", + "type": "string" + }, + { + "indexed": false, + "internalType": "bool", + "name": "active", + "type": "bool" + } + ], + "name": "FunctionRegistryChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "stateMutability": "nonpayable", + "type": "fallback" + }, + { + "inputs": [], + "name": "XVSBridge", + "outputs": [ + { + "internalType": "contract IXVSProxyOFT", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bytes4", + "name": "", + "type": "bytes4" + } + ], + "name": "functionRegistry", + "outputs": [ + { + "internalType": "string", + "name": "", + "type": "string" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "isTrustedRemote", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "remoteAddress_", + "type": "bytes" + } + ], + "name": "setTrustedRemoteAddress", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner_", + "type": "address" + } + ], + "name": "transferBridgeOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "string[]", + "name": "signatures_", + "type": "string[]" + }, + { + "internalType": "bool[]", + "name": "active_", + "type": "bool[]" + } + ], + "name": "upsertSignature", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ] + }, + "XVSBridgeAdmin_Proxy": { + "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "changeAdmin", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + } + ] + }, + "XVSProxyOFTDest": { + "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "tokenAddress_", + "type": "address" + }, + { + "internalType": "uint8", + "name": "sharedDecimals_", + "type": "uint8" + }, + { + "internalType": "address", + "name": "lzEndpoint_", + "type": "address" + }, + { + "internalType": "address", + "name": "oracle_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "sweepAmount", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "balance", + "type": "uint256" + } + ], + "name": "InsufficientBalance", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "indexed": false, + "internalType": "bytes32", + "name": "_hash", + "type": "bytes32" + } + ], + "name": "CallOFTReceivedSuccess", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "srcChainId", + "type": "uint16" + }, + { + "indexed": true, + "internalType": "bytes", + "name": "srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "nonce", + "type": "uint64" + } + ], + "name": "DropFailedMessage", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "innerToken", + "type": "address" + } + ], + "name": "InnerTokenAdded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_reason", + "type": "bytes" + } + ], + "name": "MessageFailed", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "_address", + "type": "address" + } + ], + "name": "NonContractAddress", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "oldOracle", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOracle", + "type": "address" + } + ], + "name": "OracleChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Paused", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": true, + "internalType": "address", + "name": "_to", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + } + ], + "name": "ReceiveFromChain", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "indexed": false, + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "indexed": false, + "internalType": "bytes32", + "name": "_payloadHash", + "type": "bytes32" + } + ], + "name": "RetryMessageSuccess", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "indexed": true, + "internalType": "address", + "name": "_from", + "type": "address" + }, + { + "indexed": true, + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + } + ], + "name": "SendToChain", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxDailyLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxDailyReceiveLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxSingleReceiveTransactionLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxLimit", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxLimit", + "type": "uint256" + } + ], + "name": "SetMaxSingleTransactionLimit", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint16", + "name": "_type", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "_minDstGas", + "type": "uint256" + } + ], + "name": "SetMinDstGas", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "precrime", + "type": "address" + } + ], + "name": "SetPrecrime", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_path", + "type": "bytes" + } + ], + "name": "SetTrustedRemote", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "indexed": false, + "internalType": "bytes", + "name": "_remoteAddress", + "type": "bytes" + } + ], + "name": "SetTrustedRemoteAddress", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "addr", + "type": "address" + }, + { + "indexed": false, + "internalType": "bool", + "name": "isWhitelist", + "type": "bool" + } + ], + "name": "SetWhitelist", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "token", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "to", + "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "sweepAmount", + "type": "uint256" + } + ], + "name": "SweepToken", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint16", + "name": "chainId", + "type": "uint16" + } + ], + "name": "TrustedRemoteRemoved", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "Unpaused", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "bool", + "name": "enabled", + "type": "bool" + } + ], + "name": "UpdateSendAndCallEnabled", + "type": "event" + }, + { + "inputs": [], + "name": "DEFAULT_PAYLOAD_SIZE_LIMIT", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "NO_EXTRA_GAS", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "PT_SEND", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "PT_SEND_AND_CALL", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes32", + "name": "_from", + "type": "bytes32" + }, + { + "internalType": "address", + "name": "_to", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + }, + { + "internalType": "uint256", + "name": "_gasForCall", + "type": "uint256" + } + ], + "name": "callOnOFTReceived", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourReceiveWindowStart", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourReceived", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourTransferred", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToLast24HourWindowStart", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxDailyLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxDailyReceiveLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxSingleReceiveTransactionLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "chainIdToMaxSingleTransactionLimit", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "circulatingSupply", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "", + "type": "uint64" + } + ], + "name": "creditedPackets", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "srcChainId_", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "srcAddress_", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "nonce_", + "type": "uint64" + } + ], + "name": "dropFailedMessage", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_dstGasForCall", + "type": "uint64" + }, + { + "internalType": "bool", + "name": "_useZro", + "type": "bool" + }, + { + "internalType": "bytes", + "name": "_adapterParams", + "type": "bytes" + } + ], + "name": "estimateSendAndCallFee", + "outputs": [ + { + "internalType": "uint256", + "name": "nativeFee", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "zroFee", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "internalType": "bool", + "name": "_useZro", + "type": "bool" + }, + { + "internalType": "bytes", + "name": "_adapterParams", + "type": "bytes" + } + ], + "name": "estimateSendFee", + "outputs": [ + { + "internalType": "uint256", + "name": "nativeFee", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "zroFee", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "", + "type": "uint64" + } + ], + "name": "failedMessages", + "outputs": [ + { + "internalType": "bytes32", + "name": "", + "type": "bytes32" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + } + ], + "name": "forceResumeReceive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "_chainId", + "type": "uint16" + }, + { + "internalType": "address", + "name": "", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_configType", + "type": "uint256" + } + ], + "name": "getConfig", + "outputs": [ + { + "internalType": "bytes", + "name": "", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + } + ], + "name": "getTrustedRemoteAddress", + "outputs": [ + { + "internalType": "bytes", + "name": "", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "from_", + "type": "address" + }, + { + "internalType": "uint16", + "name": "dstChainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "isEligibleToSend", + "outputs": [ + { + "internalType": "bool", + "name": "eligibleToSend", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "maxSingleTransactionLimit", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "maxDailyLimit", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "amountInUsd", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "transferredInWindow", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "last24HourWindowStart", + "type": "uint256" + }, + { + "internalType": "bool", + "name": "isWhiteListedUser", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + } + ], + "name": "isTrustedRemote", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "lzEndpoint", + "outputs": [ + { + "internalType": "contract ILayerZeroEndpoint", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + } + ], + "name": "lzReceive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "minDstGasLookup", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + } + ], + "name": "nonblockingLzReceive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "oracle", + "outputs": [ + { + "internalType": "contract ResilientOracleInterface", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "paused", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "payloadSizeLimitLookup", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "precrime", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "remoteChainId_", + "type": "uint16" + } + ], + "name": "removeTrustedRemote", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_srcChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_srcAddress", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "_nonce", + "type": "uint64" + }, + { + "internalType": "bytes", + "name": "_payload", + "type": "bytes" + } + ], + "name": "retryMessage", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "from_", + "type": "address" + }, + { + "internalType": "uint16", + "name": "dstChainId_", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "toAddress_", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "payload_", + "type": "bytes" + }, + { + "internalType": "uint64", + "name": "dstGasForCall_", + "type": "uint64" + }, + { + "components": [ + { + "internalType": "address payable", + "name": "refundAddress", + "type": "address" + }, + { + "internalType": "address", + "name": "zroPaymentAddress", + "type": "address" + }, + { + "internalType": "bytes", + "name": "adapterParams", + "type": "bytes" + } + ], + "internalType": "struct ICommonOFT.LzCallParams", + "name": "callparams_", + "type": "tuple" + } + ], + "name": "sendAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [], + "name": "sendAndCallEnabled", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_from", + "type": "address" + }, + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "bytes32", + "name": "_toAddress", + "type": "bytes32" + }, + { + "internalType": "uint256", + "name": "_amount", + "type": "uint256" + }, + { + "components": [ + { + "internalType": "address payable", + "name": "refundAddress", + "type": "address" + }, + { + "internalType": "address", + "name": "zroPaymentAddress", + "type": "address" + }, + { + "internalType": "bytes", + "name": "adapterParams", + "type": "bytes" + } + ], + "internalType": "struct ICommonOFT.LzCallParams", + "name": "_callParams", + "type": "tuple" + } + ], + "name": "sendFrom", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "_chainId", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "_configType", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "_config", + "type": "bytes" + } + ], + "name": "setConfig", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxDailyLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxDailyReceiveLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxSingleReceiveTransactionLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "chainId_", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "limit_", + "type": "uint256" + } + ], + "name": "setMaxSingleTransactionLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "uint16", + "name": "_packetType", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "_minGas", + "type": "uint256" + } + ], + "name": "setMinDstGas", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "oracleAddress_", + "type": "address" + } + ], + "name": "setOracle", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_dstChainId", + "type": "uint16" + }, + { + "internalType": "uint256", + "name": "_size", + "type": "uint256" + } + ], + "name": "setPayloadSizeLimit", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_precrime", + "type": "address" + } + ], + "name": "setPrecrime", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + } + ], + "name": "setReceiveVersion", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_version", + "type": "uint16" + } + ], + "name": "setSendVersion", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_path", + "type": "bytes" + } + ], + "name": "setTrustedRemote", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "_remoteChainId", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "_remoteAddress", + "type": "bytes" + } + ], + "name": "setTrustedRemoteAddress", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "user_", + "type": "address" + }, + { + "internalType": "bool", + "name": "val_", + "type": "bool" + } + ], + "name": "setWhitelist", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "sharedDecimals", + "outputs": [ + { + "internalType": "uint8", + "name": "", + "type": "uint8" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bytes4", + "name": "interfaceId", + "type": "bytes4" + } + ], + "name": "supportsInterface", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "contract IERC20", + "name": "token_", + "type": "address" + }, + { + "internalType": "address", + "name": "to_", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount_", + "type": "uint256" + } + ], + "name": "sweepToken", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "token", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint16", + "name": "", + "type": "uint16" + } + ], + "name": "trustedRemoteLookup", + "outputs": [ + { + "internalType": "bytes", + "name": "", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "unpause", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bool", + "name": "enabled_", + "type": "bool" + } + ], + "name": "updateSendAndCallEnabled", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "name": "whitelist", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + } + ] + } + } +} diff --git a/deployments/arbitrumsepolia_addresses.json b/deployments/arbitrumsepolia_addresses.json new file mode 100644 index 0000000..17b19d7 --- /dev/null +++ b/deployments/arbitrumsepolia_addresses.json @@ -0,0 +1,12 @@ +{ + "name": "arbitrumsepolia", + "chainId": "421614", + "addresses": { + "DefaultProxyAdmin": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", + "XVS": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "XVSBridgeAdmin": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "XVSBridgeAdmin_Implementation": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "XVSBridgeAdmin_Proxy": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "XVSProxyOFTDest": "0x8A5580d7154F9abb01836655b8594f94719b265C" + } +} From da5de5982a5c83ad74a540d658faa927e587bfa7 Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Tue, 26 Mar 2024 16:30:38 +0530 Subject: [PATCH 03/17] refactor: change tx single and daily tx limits for bsctestnet, opbnbtestnet and sepolia --- helpers/deploymentConfig.ts | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index df311bd..4d9dff5 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -126,10 +126,10 @@ export const bridgeConfig: BridgeConfig = { bsctestnet: { methods: [ { method: "setMinDstGas(uint16,uint16,uint256)", args: [10161, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10161, "500000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10161, "10000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10161, "500000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10161, "10000000000000000000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [10161, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10161, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10161, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10161, "10000000000000000000000"] }, ], }, bscmainnet: { @@ -144,10 +144,10 @@ export const bridgeConfig: BridgeConfig = { sepolia: { methods: [ { method: "setMinDstGas(uint16,uint16,uint256)", args: [10102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "500000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "500000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, ], }, ethereum: { @@ -162,10 +162,10 @@ export const bridgeConfig: BridgeConfig = { opbnbtestnet: { methods: [ { method: "setMinDstGas(uint16,uint16,uint256)", args: [10102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "500000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "500000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, ], }, opbnbmainnet: { From 5e7bdc9c34f003f0ed08aaf0e80511e652dae434 Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Tue, 26 Mar 2024 17:31:09 +0530 Subject: [PATCH 04/17] refactor: argument chain id for bridge commands and update deployments --- deployments/arbitrumsepolia/XVS.json | 32 +++---- .../arbitrumsepolia/XVSBridgeAdmin.json | 86 +++++++++---------- .../XVSBridgeAdmin_Implementation.json | 34 ++++---- .../arbitrumsepolia/XVSBridgeAdmin_Proxy.json | 84 +++++++++--------- .../arbitrumsepolia/XVSProxyOFTDest.json | 60 ++++++------- helpers/deploymentConfig.ts | 20 ++--- 6 files changed, 158 insertions(+), 158 deletions(-) diff --git a/deployments/arbitrumsepolia/XVS.json b/deployments/arbitrumsepolia/XVS.json index eea1988..a48fc03 100644 --- a/deployments/arbitrumsepolia/XVS.json +++ b/deployments/arbitrumsepolia/XVS.json @@ -1,5 +1,5 @@ { - "address": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "address": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", "abi": [ { "inputs": [ @@ -716,34 +716,34 @@ "type": "function" } ], - "transactionHash": "0xa4451e8b4ee611bccdbd94595874f92344f3c1be9ec4dc27759c713994b33746", + "transactionHash": "0x8f6f0164031904dac588c17a82a178bf480d95a4054ac385fccffda339d93356", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", - "transactionIndex": 3, - "gasUsed": "1646166", - "logsBloom": "0x00000000000000000000000200000000000000000000000400800000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000200000000000020800000000000000000800000000000000000000000000000000400000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", - "blockHash": "0xde62f7d261145afe999ab2b38c474a89bdd042a5a696a858d6ff4d3998259933", - "transactionHash": "0xa4451e8b4ee611bccdbd94595874f92344f3c1be9ec4dc27759c713994b33746", + "contractAddress": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "transactionIndex": 1, + "gasUsed": "2883252", + "logsBloom": "0x00000000000000000000000200000000000000000000000400800000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001004000000000000000000000000000000000020000000000000000000800000000000000000000000000000000400000800000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x588eec9e1599140a788294fd42247c4347f91fa5a24ba98a1e8397af7fe2ac84", + "transactionHash": "0x8f6f0164031904dac588c17a82a178bf480d95a4054ac385fccffda339d93356", "logs": [ { - "transactionIndex": 3, - "blockNumber": 27104878, - "transactionHash": "0xa4451e8b4ee611bccdbd94595874f92344f3c1be9ec4dc27759c713994b33746", - "address": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "transactionIndex": 1, + "blockNumber": 27132235, + "transactionHash": "0x8f6f0164031904dac588c17a82a178bf480d95a4054ac385fccffda339d93356", + "address": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 19, - "blockHash": "0xde62f7d261145afe999ab2b38c474a89bdd042a5a696a858d6ff4d3998259933" + "logIndex": 0, + "blockHash": "0x588eec9e1599140a788294fd42247c4347f91fa5a24ba98a1e8397af7fe2ac84" } ], - "blockNumber": 27104878, - "cumulativeGasUsed": "3274704", + "blockNumber": 27132235, + "cumulativeGasUsed": "2883252", "status": 1, "byzantium": true }, diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin.json b/deployments/arbitrumsepolia/XVSBridgeAdmin.json index 655e631..838c466 100644 --- a/deployments/arbitrumsepolia/XVSBridgeAdmin.json +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin.json @@ -1,5 +1,5 @@ { - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "abi": [ { "anonymous": false, @@ -458,82 +458,82 @@ "type": "constructor" } ], - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", - "transactionIndex": 5, - "gasUsed": "921541", - "logsBloom": "0x00000000000000000000000200000000400000000000000400800000000000040000000000000000000000000000000000200000000000000000000000008000000000000000000000000000000002000001000000000000000000000000000000000000020000000000000000000840000000800000000000000000000000400000000000000000000000000000000000000000000080000000000010800000000000000000000000000000000400000000000000800000000000000000000000000022000000000000100000040000000000000400000000000000000020000000000000000000000000000000000000000800000000000000000000000000", - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f", - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "contractAddress": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "transactionIndex": 2, + "gasUsed": "1679305", + "logsBloom": "0x00000000000000000000000200000040400020000000000400800000000000040000000000000000000000000000000000000000000000000000000000008000000000000000004000000000000002000001000000000000000000000000000000000000020000040000000000000800000000800000000000000000000000400000000000000000000000000000000000000000000080000000000000800000000000000000000000000001000400000000000000800000000000000000000000000020000000000000000000040000000000000400000000000000000020000200000000000000000000000000000000000800000000000000000000000000", + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32", + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", "logs": [ { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": [ "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", - "0x000000000000000000000000cacdfb7cba8b0f4b4f6c842f4d19b03ef1453235" + "0x000000000000000000000000d2048bd9e1d9a515cc57e270d0928b1127348ae1" ], "data": "0x", - "logIndex": 10, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 4, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 11, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 5, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": ["0x66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f", - "logIndex": 12, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 6, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], "data": "0x0000000000000000000000000000000000000000000000000000000000000001", - "logIndex": 13, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 7, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a78a1df376c3ceebc5fab574fe6eddbbf76fd03e", - "logIndex": 14, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 8, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" } ], - "blockNumber": 27104954, - "cumulativeGasUsed": "2395016", + "blockNumber": 27132301, + "cumulativeGasUsed": "3399219", "status": 1, "byzantium": true }, "args": [ - "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", "0xc4d66de8000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f" ], @@ -546,7 +546,7 @@ "methodName": "initialize", "args": ["0xa36AD96441cB931D8dFEAAaC97D3FaB4B39E590F"] }, - "implementation": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "implementation": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", "devdoc": { "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", "kind": "dev", diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json b/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json index c1dea6e..3d90a5f 100644 --- a/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json @@ -1,5 +1,5 @@ { - "address": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "address": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", "abi": [ { "inputs": [ @@ -329,34 +329,34 @@ "type": "function" } ], - "transactionHash": "0x06fc510c4442619cab163901c33cc571ee30189320559aac202a5a5ff9e1c360", + "transactionHash": "0x4dfe6686fb9890a60513d16b09040dd4859a2907964ee4fd300c43d1cf74cfed", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", - "transactionIndex": 2, - "gasUsed": "1417014", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080010000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000", - "blockHash": "0xf9c24f53bccdd04a09907818d68da24ccbb3a427bb56392140102590267d2cc9", - "transactionHash": "0x06fc510c4442619cab163901c33cc571ee30189320559aac202a5a5ff9e1c360", + "contractAddress": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "transactionIndex": 3, + "gasUsed": "2496583", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000200000800400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000", + "blockHash": "0x7ab0ebc08e18039f5ba3a0a03d07fccb15aa35f801a14cc59b44b9306e555581", + "transactionHash": "0x4dfe6686fb9890a60513d16b09040dd4859a2907964ee4fd300c43d1cf74cfed", "logs": [ { - "transactionIndex": 2, - "blockNumber": 27104932, - "transactionHash": "0x06fc510c4442619cab163901c33cc571ee30189320559aac202a5a5ff9e1c360", - "address": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "transactionIndex": 3, + "blockNumber": 27132283, + "transactionHash": "0x4dfe6686fb9890a60513d16b09040dd4859a2907964ee4fd300c43d1cf74cfed", + "address": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], "data": "0x00000000000000000000000000000000000000000000000000000000000000ff", - "logIndex": 3, - "blockHash": "0xf9c24f53bccdd04a09907818d68da24ccbb3a427bb56392140102590267d2cc9" + "logIndex": 6, + "blockHash": "0x7ab0ebc08e18039f5ba3a0a03d07fccb15aa35f801a14cc59b44b9306e555581" } ], - "blockNumber": 27104932, - "cumulativeGasUsed": "2537511", + "blockNumber": 27132283, + "cumulativeGasUsed": "4260614", "status": 1, "byzantium": true }, - "args": ["0x8A5580d7154F9abb01836655b8594f94719b265C"], + "args": ["0xE9B66800E63888DE29c4c9131faadbDbDCfae917"], "numDeployments": 1, "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"XVSBridge_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"sender\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"calledContract\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"methodSignature\",\"type\":\"string\"}],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"string\",\"name\":\"signature\",\"type\":\"string\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"}],\"name\":\"FunctionRegistryChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferStarted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"stateMutability\":\"nonpayable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"XVSBridge\",\"outputs\":[{\"internalType\":\"contract IXVSProxyOFT\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"acceptOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"contract IAccessControlManagerV8\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"name\":\"functionRegistry\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pendingOwner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner_\",\"type\":\"address\"}],\"name\":\"transferBridgeOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string[]\",\"name\":\"signatures_\",\"type\":\"string[]\"},{\"internalType\":\"bool[]\",\"name\":\"active_\",\"type\":\"bool[]\"}],\"name\":\"upsertSignature\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"acceptOwnership()\":{\"details\":\"The new owner accepts the ownership transfer.\"},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"initialize(address)\":{\"params\":{\"accessControlManager_\":\"Address of access control manager contract.\"}},\"isTrustedRemote(uint16,bytes)\":{\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"},\"returns\":{\"_0\":\"Bool indicating whether the remote chain is trusted or not.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pendingOwner()\":{\"details\":\"Returns the address of the pending owner.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only Governance\",\"custom:event\":\"Emits NewAccessControlManager event\",\"details\":\"Admin function to set address of AccessControlManager\",\"params\":{\"accessControlManager_\":\"The new address of the AccessControlManager\"}},\"setTrustedRemoteAddress(uint16,bytes)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"}},\"transferBridgeOwnership(address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"params\":{\"newOwner_\":\"New owner of the XVS Bridge.\"}},\"transferOwnership(address)\":{\"details\":\"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.\"},\"upsertSignature(string[],bool[])\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits FunctionRegistryChanged if bool value of function changes.\",\"params\":{\"active_\":\"bool value, should be true to add function.\",\"signatures_\":\"Function signature to be added or removed.\"}}},\"stateVariables\":{\"XVSBridge\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"}},\"title\":\"XVSBridgeAdmin\",\"version\":1},\"userdoc\":{\"errors\":{\"Unauthorized(address,address,string)\":[{\"notice\":\"Thrown when the action is prohibited by AccessControlManager\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"FunctionRegistryChanged(string,bool)\":{\"notice\":\"emitted when function registry updated\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when access control manager contract address is changed\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Returns the address of the access control manager contract\"},\"functionRegistry(bytes4)\":{\"notice\":\"A mapping keeps track of function signature associated with function name string.\"},\"isTrustedRemote(uint16,bytes)\":{\"notice\":\"Returns true if remote address is trustedRemote corresponds to chainId_.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of AccessControlManager\"},\"setTrustedRemoteAddress(uint16,bytes)\":{\"notice\":\"Sets trusted remote on particular chain.\"},\"transferBridgeOwnership(address)\":{\"notice\":\"This function transfers the ownership of the bridge from this contract to new owner.\"},\"upsertSignature(string[],bool[])\":{\"notice\":\"A setter for the registry of functions that are allowed to be executed from proposals.\"}},\"notice\":\"The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT. It maintains a registry of function signatures and names, allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSBridgeAdmin.sol\":\"XVSBridgeAdmin\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OwnableUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership} and {acceptOwnership}.\\n *\\n * This module is used through inheritance. It will make available all functions\\n * from parent (Ownable).\\n */\\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\\n function __Ownable2Step_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable2Step_init_unchained() internal onlyInitializing {\\n }\\n address private _pendingOwner;\\n\\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Returns the address of the pending owner.\\n */\\n function pendingOwner() public view virtual returns (address) {\\n return _pendingOwner;\\n }\\n\\n /**\\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual override onlyOwner {\\n _pendingOwner = newOwner;\\n emit OwnershipTransferStarted(owner(), newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual override {\\n delete _pendingOwner;\\n super._transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev The new owner accepts the ownership transfer.\\n */\\n function acceptOwnership() public virtual {\\n address sender = _msgSender();\\n require(pendingOwner() == sender, \\\"Ownable2Step: caller is not the new owner\\\");\\n _transferOwnership(sender);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x84efb8889801b0ac817324aff6acc691d07bbee816b671817132911d287a8c63\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/ContextUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n function __Ownable_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable_init_unchained() internal onlyInitializing {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x4075622496acc77fd6d4de4cc30a8577a744d5c75afad33fdeacf1704d6eda98\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../../utils/AddressUpgradeable.sol\\\";\\n\\n/**\\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\\n *\\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\\n * reused. This mechanism prevents re-execution of each \\\"step\\\" but allows the creation of new initialization steps in\\n * case an upgrade adds a module that needs to be initialized.\\n *\\n * For example:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```solidity\\n * contract MyToken is ERC20Upgradeable {\\n * function initialize() initializer public {\\n * __ERC20_init(\\\"MyToken\\\", \\\"MTK\\\");\\n * }\\n * }\\n *\\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\\n * function initializeV2() reinitializer(2) public {\\n * __ERC20Permit_init(\\\"MyToken\\\");\\n * }\\n * }\\n * ```\\n *\\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\\n *\\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\\n *\\n * [CAUTION]\\n * ====\\n * Avoid leaving a contract uninitialized.\\n *\\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```\\n * /// @custom:oz-upgrades-unsafe-allow constructor\\n * constructor() {\\n * _disableInitializers();\\n * }\\n * ```\\n * ====\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n * @custom:oz-retyped-from bool\\n */\\n uint8 private _initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private _initializing;\\n\\n /**\\n * @dev Triggered when the contract has been initialized or reinitialized.\\n */\\n event Initialized(uint8 version);\\n\\n /**\\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\\n * `onlyInitializing` functions can be used to initialize parent contracts.\\n *\\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\\n * constructor.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier initializer() {\\n bool isTopLevelCall = !_initializing;\\n require(\\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n _initialized = 1;\\n if (isTopLevelCall) {\\n _initializing = true;\\n }\\n _;\\n if (isTopLevelCall) {\\n _initializing = false;\\n emit Initialized(1);\\n }\\n }\\n\\n /**\\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\\n * used to initialize parent contracts.\\n *\\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\\n * are added through upgrades and that require initialization.\\n *\\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\\n * cannot be nested. If one is invoked in the context of another, execution will revert.\\n *\\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\\n * a contract, executing them in the right order is up to the developer or operator.\\n *\\n * WARNING: setting the version to 255 will prevent any future reinitialization.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier reinitializer(uint8 version) {\\n require(!_initializing && _initialized < version, \\\"Initializable: contract is already initialized\\\");\\n _initialized = version;\\n _initializing = true;\\n _;\\n _initializing = false;\\n emit Initialized(version);\\n }\\n\\n /**\\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\\n */\\n modifier onlyInitializing() {\\n require(_initializing, \\\"Initializable: contract is not initializing\\\");\\n _;\\n }\\n\\n /**\\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\\n * through proxies.\\n *\\n * Emits an {Initialized} event the first time it is successfully executed.\\n */\\n function _disableInitializers() internal virtual {\\n require(!_initializing, \\\"Initializable: contract is initializing\\\");\\n if (_initialized != type(uint8).max) {\\n _initialized = type(uint8).max;\\n emit Initialized(type(uint8).max);\\n }\\n }\\n\\n /**\\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\\n */\\n function _getInitializedVersion() internal view returns (uint8) {\\n return _initialized;\\n }\\n\\n /**\\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\\n */\\n function _isInitializing() internal view returns (bool) {\\n return _initializing;\\n }\\n}\\n\",\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary AddressUpgradeable {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract ContextUpgradeable is Initializable {\\n function __Context_init() internal onlyInitializing {\\n }\\n\\n function __Context_init_unchained() internal onlyInitializing {\\n }\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[50] private __gap;\\n}\\n\",\"keccak256\":\"0x963ea7f0b48b032eef72fe3a7582edf78408d6f834115b9feadd673a4d5bd149\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\\\";\\nimport \\\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\\\";\\n\\nimport \\\"./IAccessControlManagerV8.sol\\\";\\n\\n/**\\n * @title AccessControlledV8\\n * @author Venus\\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\\n */\\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\\n /// @notice Access control manager contract\\n IAccessControlManagerV8 private _accessControlManager;\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n\\n /// @notice Emitted when access control manager contract address is changed\\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\\n\\n /// @notice Thrown when the action is prohibited by AccessControlManager\\n error Unauthorized(address sender, address calledContract, string methodSignature);\\n\\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\\n __Ownable2Step_init();\\n __AccessControlled_init_unchained(accessControlManager_);\\n }\\n\\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Sets the address of AccessControlManager\\n * @dev Admin function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n * @custom:event Emits NewAccessControlManager event\\n * @custom:access Only Governance\\n */\\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Returns the address of the access control manager contract\\n */\\n function accessControlManager() external view returns (IAccessControlManagerV8) {\\n return _accessControlManager;\\n }\\n\\n /**\\n * @dev Internal function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n */\\n function _setAccessControlManager(address accessControlManager_) internal {\\n require(address(accessControlManager_) != address(0), \\\"invalid acess control manager address\\\");\\n address oldAccessControlManager = address(_accessControlManager);\\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\\n }\\n\\n /**\\n * @notice Reverts if the call is not allowed by AccessControlManager\\n * @param signature Method signature\\n */\\n function _checkAccessAllowed(string memory signature) internal view {\\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\\n\\n if (!isAllowedToCall) {\\n revert Unauthorized(msg.sender, address(this), signature);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x1b805a5d09990e2c4f7839afe7726a02f8452261eb3d0d488e24129ec0a7736d\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x8adbe291d659987faf4de606736227ad9d8e1a0e284a33a6ca12b30ab2a504b2\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSBridgeAdmin.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\n\\npragma solidity 0.8.13;\\n\\nimport { AccessControlledV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { IXVSProxyOFT } from \\\"./interfaces/IXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSBridgeAdmin\\n * @author Venus\\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\\n * It maintains a registry of function signatures and names,\\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\\n */\\ncontract XVSBridgeAdmin is AccessControlledV8 {\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IXVSProxyOFT public immutable XVSBridge;\\n /**\\n * @notice A mapping keeps track of function signature associated with function name string.\\n */\\n mapping(bytes4 => string) public functionRegistry;\\n\\n /**\\n * @notice emitted when function registry updated\\n */\\n event FunctionRegistryChanged(string signature, bool active);\\n\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(address XVSBridge_) {\\n ensureNonzeroAddress(XVSBridge_);\\n XVSBridge = IXVSProxyOFT(XVSBridge_);\\n _disableInitializers();\\n }\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n */\\n function initialize(address accessControlManager_) external initializer {\\n __AccessControlled_init(accessControlManager_);\\n }\\n\\n /**\\n * @notice Invoked when called function does not exist in the contract.\\n * @return Response of low level call.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n fallback(bytes calldata data) external returns (bytes memory) {\\n string memory fun = _getFunctionName(msg.sig);\\n require(bytes(fun).length != 0, \\\"Function not found\\\");\\n _checkAccessAllowed(fun);\\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\\n require(ok, \\\"call failed\\\");\\n return res;\\n }\\n\\n /**\\n * @notice Sets trusted remote on particular chain.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n */\\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\\n _checkAccessAllowed(\\\"setTrustedRemoteAddress(uint16,bytes)\\\");\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\\n * @param signatures_ Function signature to be added or removed.\\n * @param active_ bool value, should be true to add function.\\n * @custom:access Only owner.\\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\\n */\\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\\n uint256 signatureLength = signatures_.length;\\n require(signatureLength == active_.length, \\\"Input arrays must have the same length\\\");\\n for (uint256 i; i < signatureLength; ) {\\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\\n bytes memory signature = bytes(functionRegistry[sigHash]);\\n if (active_[i] && signature.length == 0) {\\n functionRegistry[sigHash] = signatures_[i];\\n emit FunctionRegistryChanged(signatures_[i], true);\\n } else if (!active_[i] && signature.length != 0) {\\n delete functionRegistry[sigHash];\\n emit FunctionRegistryChanged(signatures_[i], false);\\n }\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /**\\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\\n * @param newOwner_ New owner of the XVS Bridge.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function transferBridgeOwnership(address newOwner_) external {\\n _checkAccessAllowed(\\\"transferBridgeOwnership(address)\\\");\\n XVSBridge.transferOwnership(newOwner_);\\n }\\n\\n /**\\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n * @return Bool indicating whether the remote chain is trusted or not.\\n */\\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @dev Returns function name string associated with function signature.\\n * @param signature_ Four bytes of function signature.\\n * @return Function signature corresponding to its hash.\\n */\\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\\n return functionRegistry[signature_];\\n }\\n\\n /**\\n * @notice Converts given bytes into address.\\n * @param b Bytes to be converted into address.\\n * @return Converted address of given bytes.\\n */\\n function bytesToAddress(bytes calldata b) private pure returns (address) {\\n return address(uint160(bytes20(b)));\\n }\\n}\\n\",\"keccak256\":\"0x3ba34b95f911e1772aca61e6daa00c4ebdb5bee61fc072ffba9e7ff3dc1262cd\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/**\\n * @title IXVSProxyOFT\\n * @author Venus\\n * @notice Interface implemented by `XVSProxyOFT`.\\n */\\ninterface IXVSProxyOFT {\\n function transferOwnership(address addr) external;\\n\\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\\n\\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\\n}\\n\",\"keccak256\":\"0x854518f3e4c2270ca52184e63dc1f9d27f2893388216ee6153e6ab8cf2d7c960\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json b/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json index b962385..d9c4842 100644 --- a/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json @@ -1,5 +1,5 @@ { - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "abi": [ { "inputs": [ @@ -146,82 +146,82 @@ "type": "receive" } ], - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", - "transactionIndex": 5, - "gasUsed": "921541", - "logsBloom": "0x00000000000000000000000200000000400000000000000400800000000000040000000000000000000000000000000000200000000000000000000000008000000000000000000000000000000002000001000000000000000000000000000000000000020000000000000000000840000000800000000000000000000000400000000000000000000000000000000000000000000080000000000010800000000000000000000000000000000400000000000000800000000000000000000000000022000000000000100000040000000000000400000000000000000020000000000000000000000000000000000000000800000000000000000000000000", - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f", - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", + "contractAddress": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "transactionIndex": 2, + "gasUsed": "1679305", + "logsBloom": "0x00000000000000000000000200000040400020000000000400800000000000040000000000000000000000000000000000000000000000000000000000008000000000000000004000000000000002000001000000000000000000000000000000000000020000040000000000000800000000800000000000000000000000400000000000000000000000000000000000000000000080000000000000800000000000000000000000000001000400000000000000800000000000000000000000000020000000000000000000040000000000000400000000000000000020000200000000000000000000000000000000000800000000000000000000000000", + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32", + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", "logs": [ { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": [ "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", - "0x000000000000000000000000cacdfb7cba8b0f4b4f6c842f4d19b03ef1453235" + "0x000000000000000000000000d2048bd9e1d9a515cc57e270d0928b1127348ae1" ], "data": "0x", - "logIndex": 10, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 4, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 11, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 5, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": ["0x66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f", - "logIndex": 12, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 6, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], "data": "0x0000000000000000000000000000000000000000000000000000000000000001", - "logIndex": 13, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 7, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" }, { - "transactionIndex": 5, - "blockNumber": 27104954, - "transactionHash": "0x00847afebb038e883d2e493d8e0dd53315661a1378b772a9d0ad9b7800cf956d", - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "transactionIndex": 2, + "blockNumber": 27132301, + "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a78a1df376c3ceebc5fab574fe6eddbbf76fd03e", - "logIndex": 14, - "blockHash": "0xf1a2ac69f9fbfc2157e069168b0ca9a46480549e21d7e5c709be3fb15589df7f" + "logIndex": 8, + "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" } ], - "blockNumber": 27104954, - "cumulativeGasUsed": "2395016", + "blockNumber": 27132301, + "cumulativeGasUsed": "3399219", "status": 1, "byzantium": true }, "args": [ - "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", "0xc4d66de8000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f" ], diff --git a/deployments/arbitrumsepolia/XVSProxyOFTDest.json b/deployments/arbitrumsepolia/XVSProxyOFTDest.json index e5aa17e..eaeacb0 100644 --- a/deployments/arbitrumsepolia/XVSProxyOFTDest.json +++ b/deployments/arbitrumsepolia/XVSProxyOFTDest.json @@ -1,5 +1,5 @@ { - "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", "abi": [ { "inputs": [ @@ -1891,66 +1891,66 @@ "type": "function" } ], - "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x8A5580d7154F9abb01836655b8594f94719b265C", - "transactionIndex": 1, - "gasUsed": "5402923", - "logsBloom": "0x00000000000000000000000200000000000000000004000400800000000000040000000000000000000010000000000008000000000000000000200000000000000000000000000000080000000000000001000020000000000000800000010000000000020000000000000000000800020000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080400000000000000000000000100000000000000010000000040000000000000000000000000000000000000000000000000000000000000000000000000020000000800000000000000000000000000000000000000000000000000000000000", - "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7", - "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", + "contractAddress": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", + "transactionIndex": 3, + "gasUsed": "9090719", + "logsBloom": "0x00000000000000000000000200000000000000000000000400800000000000040000000000000000000000000000000008000000000000000000200000000000000000000000000000080000000000000001000020000000000000000000000000000000020000000000000000000800000000000000000000000000800000400000000000000000000000000000000000000000100000000000000000000080400000000000000000080000100000000000002010000000040000000000000000000000000000000000000000000000000000000200000000000000000020000000000000000000000000400000000000000000000000000000000000000000", + "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed", + "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", "logs": [ { - "transactionIndex": 1, - "blockNumber": 27104908, - "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", - "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "transactionIndex": 3, + "blockNumber": 27132260, + "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", + "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 0, - "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7" + "logIndex": 20, + "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed" }, { - "transactionIndex": 1, - "blockNumber": 27104908, - "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", - "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "transactionIndex": 3, + "blockNumber": 27132260, + "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", + "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", "topics": [ "0x0b673f021ff9a27bbe58f282908695869e130b3103029190387b83650806c2c3", - "0x0000000000000000000000008f377098e488d227e809bd56d30c9fd8388245d3" + "0x00000000000000000000000047fa6e9f717c9eb081c4734ffb5a1ecd70508891" ], "data": "0x", - "logIndex": 1, - "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7" + "logIndex": 21, + "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed" }, { - "transactionIndex": 1, - "blockNumber": 27104908, - "transactionHash": "0xd869f101af2cabc5dea707d49d25380f2e44a9c0988d31d2c9c8662e57151aec", - "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "transactionIndex": 3, + "blockNumber": 27132260, + "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", + "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", "topics": [ "0x05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000006708bad042916b47311c8078b29d7f432342102f" ], "data": "0x", - "logIndex": 2, - "blockHash": "0xc9c8255102fae4cb8d12714da1ce03075589b611e50e66ba942e21e005af76b7" + "logIndex": 22, + "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed" } ], - "blockNumber": 27104908, - "cumulativeGasUsed": "5402923", + "blockNumber": 27132260, + "cumulativeGasUsed": "10502621", "status": 1, "byzantium": true }, "args": [ - "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", 8, "0x6098e96a28E02f27B1e6BD381f870F1C8Bd169d3", "0x6708bAd042916B47311c8078b29d7f432342102F" diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index 4d9dff5..d4d4e36 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -179,20 +179,20 @@ export const bridgeConfig: BridgeConfig = { }, arbitrumsepolia: { methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [10231, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10231, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10231, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10231, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10231, "10000000000000000000000"] }, + { method: "setMinDstGas(uint16,uint16,uint256)", args: [10102, 0, "300000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, ], }, arbitrumone: { methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [110, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [110, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [110, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [110, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [110, "10000000000000000000000"] }, + { method: "setMinDstGas(uint16,uint16,uint256)", args: [102, 0, "300000"] }, + { method: "setMaxDailyLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, + { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, + { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, + { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, ], }, }; From a763f74f996d4fbc1f805660c8c9c7415409a03a Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Tue, 26 Mar 2024 12:02:15 +0000 Subject: [PATCH 05/17] feat: updating deployment files --- deployments/arbitrumsepolia.json | 10 +++++----- deployments/arbitrumsepolia_addresses.json | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/deployments/arbitrumsepolia.json b/deployments/arbitrumsepolia.json index 2951d2e..f5bb774 100644 --- a/deployments/arbitrumsepolia.json +++ b/deployments/arbitrumsepolia.json @@ -168,7 +168,7 @@ ] }, "XVS": { - "address": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", + "address": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", "abi": [ { "inputs": [ @@ -887,7 +887,7 @@ ] }, "XVSBridgeAdmin": { - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "abi": [ { "anonymous": false, @@ -1348,7 +1348,7 @@ ] }, "XVSBridgeAdmin_Implementation": { - "address": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", + "address": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", "abi": [ { "inputs": [ @@ -1680,7 +1680,7 @@ ] }, "XVSBridgeAdmin_Proxy": { - "address": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", + "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", "abi": [ { "inputs": [ @@ -1829,7 +1829,7 @@ ] }, "XVSProxyOFTDest": { - "address": "0x8A5580d7154F9abb01836655b8594f94719b265C", + "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", "abi": [ { "inputs": [ diff --git a/deployments/arbitrumsepolia_addresses.json b/deployments/arbitrumsepolia_addresses.json index 17b19d7..f895629 100644 --- a/deployments/arbitrumsepolia_addresses.json +++ b/deployments/arbitrumsepolia_addresses.json @@ -3,10 +3,10 @@ "chainId": "421614", "addresses": { "DefaultProxyAdmin": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", - "XVS": "0x8f377098e488D227e809BD56D30C9Fd8388245D3", - "XVSBridgeAdmin": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", - "XVSBridgeAdmin_Implementation": "0xcAcDfB7Cba8B0f4b4f6C842f4d19b03EF1453235", - "XVSBridgeAdmin_Proxy": "0x649c35088bAd6847fF163B15d0e7A00943D7FD40", - "XVSProxyOFTDest": "0x8A5580d7154F9abb01836655b8594f94719b265C" + "XVS": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "XVSBridgeAdmin": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "XVSBridgeAdmin_Implementation": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "XVSBridgeAdmin_Proxy": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "XVSProxyOFTDest": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917" } } From e67934668330062341da08154722ce5b3d9cec6f Mon Sep 17 00:00:00 2001 From: Kirill Kuvshinov Date: Fri, 12 Apr 2024 12:19:33 +0300 Subject: [PATCH 06/17] feat!: migrate to Solidity 0.8.25 --- contracts/Bridge/BaseXVSProxyOFT.sol | 2 +- contracts/Bridge/XVSBridgeAdmin.sol | 3 +- contracts/Bridge/XVSProxyOFTDest.sol | 2 +- contracts/Bridge/XVSProxyOFTSrc.sol | 2 +- contracts/Bridge/interfaces/IXVS.sol | 2 +- contracts/Bridge/interfaces/IXVSProxyOFT.sol | 2 +- contracts/Bridge/token/TokenController.sol | 3 +- contracts/Bridge/token/XVS.sol | 2 +- hardhat.config.ts | 3 +- package.json | 6 +-- yarn.lock | 45 ++++++++++++++------ 11 files changed, 46 insertions(+), 26 deletions(-) diff --git a/contracts/Bridge/BaseXVSProxyOFT.sol b/contracts/Bridge/BaseXVSProxyOFT.sol index 69685a0..7b7041c 100644 --- a/contracts/Bridge/BaseXVSProxyOFT.sol +++ b/contracts/Bridge/BaseXVSProxyOFT.sol @@ -1,5 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity 0.8.25; import { SafeERC20, IERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import { ResilientOracleInterface } from "@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol"; diff --git a/contracts/Bridge/XVSBridgeAdmin.sol b/contracts/Bridge/XVSBridgeAdmin.sol index ac61317..038a947 100644 --- a/contracts/Bridge/XVSBridgeAdmin.sol +++ b/contracts/Bridge/XVSBridgeAdmin.sol @@ -1,6 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause - -pragma solidity 0.8.13; +pragma solidity 0.8.25; import { AccessControlledV8 } from "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol"; import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; diff --git a/contracts/Bridge/XVSProxyOFTDest.sol b/contracts/Bridge/XVSProxyOFTDest.sol index 5f1aa3e..ee9e3c3 100644 --- a/contracts/Bridge/XVSProxyOFTDest.sol +++ b/contracts/Bridge/XVSProxyOFTDest.sol @@ -1,5 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity 0.8.25; import { IXVS } from "./interfaces/IXVS.sol"; import { BaseXVSProxyOFT } from "./BaseXVSProxyOFT.sol"; diff --git a/contracts/Bridge/XVSProxyOFTSrc.sol b/contracts/Bridge/XVSProxyOFTSrc.sol index fcd4da1..923c980 100644 --- a/contracts/Bridge/XVSProxyOFTSrc.sol +++ b/contracts/Bridge/XVSProxyOFTSrc.sol @@ -1,5 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity 0.8.25; import { SafeERC20, IERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import { BaseXVSProxyOFT } from "./BaseXVSProxyOFT.sol"; diff --git a/contracts/Bridge/interfaces/IXVS.sol b/contracts/Bridge/interfaces/IXVS.sol index fcbc222..fed4af9 100644 --- a/contracts/Bridge/interfaces/IXVS.sol +++ b/contracts/Bridge/interfaces/IXVS.sol @@ -1,5 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity ^0.8.25; /** * @title IXVS diff --git a/contracts/Bridge/interfaces/IXVSProxyOFT.sol b/contracts/Bridge/interfaces/IXVSProxyOFT.sol index 78d92b1..04becee 100644 --- a/contracts/Bridge/interfaces/IXVSProxyOFT.sol +++ b/contracts/Bridge/interfaces/IXVSProxyOFT.sol @@ -1,5 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity ^0.8.25; /** * @title IXVSProxyOFT diff --git a/contracts/Bridge/token/TokenController.sol b/contracts/Bridge/token/TokenController.sol index cf87ebd..e0a3567 100644 --- a/contracts/Bridge/token/TokenController.sol +++ b/contracts/Bridge/token/TokenController.sol @@ -1,5 +1,6 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity 0.8.25; + import { IAccessControlManagerV8 } from "@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol"; import { Pausable } from "@openzeppelin/contracts/security/Pausable.sol"; import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol"; diff --git a/contracts/Bridge/token/XVS.sol b/contracts/Bridge/token/XVS.sol index b1a64ff..0e2bf20 100644 --- a/contracts/Bridge/token/XVS.sol +++ b/contracts/Bridge/token/XVS.sol @@ -1,5 +1,5 @@ // SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.13; +pragma solidity 0.8.25; import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol"; diff --git a/hardhat.config.ts b/hardhat.config.ts index 082044e..61db88e 100644 --- a/hardhat.config.ts +++ b/hardhat.config.ts @@ -69,7 +69,7 @@ const config: HardhatUserConfig = { solidity: { compilers: [ { - version: "0.8.13", + version: "0.8.25", settings: { optimizer: { enabled: true, @@ -77,6 +77,7 @@ const config: HardhatUserConfig = { yul: !process.env.CI, }, }, + evmVersion: "paris", outputSelection: { "*": { "*": ["storageLayout"], diff --git a/package.json b/package.json index f7999b6..faf3730 100644 --- a/package.json +++ b/package.json @@ -60,9 +60,9 @@ "@types/node": "^12.20.50", "@typescript-eslint/eslint-plugin": "^5.27.1", "@typescript-eslint/parser": "^5.27.1", - "@venusprotocol/governance-contracts": "^1.4.0", - "@venusprotocol/oracle": "^1.8.0", - "@venusprotocol/solidity-utilities": "1.1.0", + "@venusprotocol/governance-contracts": "^2.0.0", + "@venusprotocol/oracle": "^2.0.0", + "@venusprotocol/solidity-utilities": "2.0.0", "bignumber.js": "9.0.0", "chai": "^4.3.6", "dotenv": "^10.0.0", diff --git a/yarn.lock b/yarn.lock index 7f1d771..0e7f433 100644 --- a/yarn.lock +++ b/yarn.lock @@ -3052,7 +3052,7 @@ __metadata: languageName: node linkType: hard -"@venusprotocol/governance-contracts@npm:^1.4.0, @venusprotocol/governance-contracts@npm:^1.4.0-dev.1, @venusprotocol/governance-contracts@npm:^1.4.0-dev.9": +"@venusprotocol/governance-contracts@npm:^1.4.0-dev.1": version: 1.4.0 resolution: "@venusprotocol/governance-contracts@npm:1.4.0" dependencies: @@ -3063,23 +3063,35 @@ __metadata: languageName: node linkType: hard -"@venusprotocol/oracle@npm:^1.8.0": - version: 1.8.0 - resolution: "@venusprotocol/oracle@npm:1.8.0" +"@venusprotocol/governance-contracts@npm:^2.0.0": + version: 2.0.0 + resolution: "@venusprotocol/governance-contracts@npm:2.0.0" + dependencies: + "@venusprotocol/solidity-utilities": 2.0.0 + hardhat-deploy-ethers: ^0.3.0-beta.13 + module-alias: ^2.2.2 + checksum: 18b56d951c4e68fa1edadc93ed44daa55c8b81294778a4969d940a084de6d949630eacd4702d1b92f04ad5d709963a3a0a790014871ec34b0b2f4806cebc731c + languageName: node + linkType: hard + +"@venusprotocol/oracle@npm:^2.0.0": + version: 2.0.0 + resolution: "@venusprotocol/oracle@npm:2.0.0" dependencies: "@chainlink/contracts": ^0.5.1 "@defi-wonderland/smock": ^2.3.4 "@nomicfoundation/hardhat-network-helpers": ^1.0.8 "@openzeppelin/contracts": ^4.6.0 "@openzeppelin/contracts-upgradeable": ^4.7.3 - "@venusprotocol/governance-contracts": ^1.4.0-dev.9 + "@venusprotocol/governance-contracts": ^2.0.0 + "@venusprotocol/solidity-utilities": ^2.0.0 "@venusprotocol/venus-protocol": ^6.0.0 ethers: ^5.6.8 hardhat: ^2.16.1 hardhat-deploy: ^0.11.14 module-alias: ^2.2.2 solidity-docgen: ^0.6.0-beta.29 - checksum: 3ea02a9686e80ce0b378aa5197fd46b2c02b089bd5512afe673d6d45e3091e280dbf04788400ea47bee4151182b4b39c981207e1d42fbe2b970161b29abcfee1 + checksum: 00673550cdc63244eba2872b32253454a3b2062c2759075c68449b2923f2bb645e971d5ca0cbfd288bddd092d346a5f3e49d10bbb97d743fb33f9ece14179723 languageName: node linkType: hard @@ -3100,10 +3112,10 @@ __metadata: languageName: node linkType: hard -"@venusprotocol/solidity-utilities@npm:1.1.0, @venusprotocol/solidity-utilities@npm:^1.1.0": - version: 1.1.0 - resolution: "@venusprotocol/solidity-utilities@npm:1.1.0" - checksum: 3b17ec451cd0ba5aaea76686c7bef35757fb158709214be094f73ebd0d643c79817159f7aa162cc694e1a5ee1f02b20e26211a65929113b985827959aae99fa7 +"@venusprotocol/solidity-utilities@npm:2.0.0, @venusprotocol/solidity-utilities@npm:^2.0.0": + version: 2.0.0 + resolution: "@venusprotocol/solidity-utilities@npm:2.0.0" + checksum: 87a2ce2fd1d702bc04c4e98d675b904176c7f2489476e8da586d1782b48faae92aa4f2ba894737773d189ba72a6b274f1464cf2e0308e62758303d0adde749e6 languageName: node linkType: hard @@ -3114,6 +3126,13 @@ __metadata: languageName: node linkType: hard +"@venusprotocol/solidity-utilities@npm:^1.1.0": + version: 1.1.0 + resolution: "@venusprotocol/solidity-utilities@npm:1.1.0" + checksum: 3b17ec451cd0ba5aaea76686c7bef35757fb158709214be094f73ebd0d643c79817159f7aa162cc694e1a5ee1f02b20e26211a65929113b985827959aae99fa7 + languageName: node + linkType: hard + "@venusprotocol/token-bridge@workspace:.": version: 0.0.0-use.local resolution: "@venusprotocol/token-bridge@workspace:." @@ -3141,9 +3160,9 @@ __metadata: "@types/node": ^12.20.50 "@typescript-eslint/eslint-plugin": ^5.27.1 "@typescript-eslint/parser": ^5.27.1 - "@venusprotocol/governance-contracts": ^1.4.0 - "@venusprotocol/oracle": ^1.8.0 - "@venusprotocol/solidity-utilities": 1.1.0 + "@venusprotocol/governance-contracts": ^2.0.0 + "@venusprotocol/oracle": ^2.0.0 + "@venusprotocol/solidity-utilities": 2.0.0 bignumber.js: 9.0.0 chai: ^4.3.6 dotenv: ^10.0.0 From c16f8f99ca35ff2a6464a04f369ada4b3e3bf5db Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Wed, 17 Apr 2024 18:26:42 +0530 Subject: [PATCH 07/17] refactor: add bridgeConfig for all networks --- helpers/deploymentConfig.ts | 92 +++++++++++++++---------------------- 1 file changed, 36 insertions(+), 56 deletions(-) diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index d4d4e36..b55372a 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -1,3 +1,6 @@ +import { BigNumber } from "ethers"; +import { parseUnits } from "ethers/lib/utils"; + export type PreconfiguredAddresses = { [contract: string]: string }; interface BridgeConfig { @@ -6,6 +9,11 @@ interface BridgeConfig { }; } +type MethodEntry = { + method: string; + args: (BigNumber | number)[]; +}; + const SEPOLIA_MULTISIG = "0x94fa6078b6b8a26f0b6edffbe6501b22a10470fb"; const OPBNB_TESTNET_MULTISIG = "0xb15f6EfEbC276A3b9805df81b5FB3D50C2A62BDf"; const OPBNB_MAINNET_MULTISIG = "0xC46796a21a3A9FAB6546aF3434F2eBfFd0604207"; @@ -124,76 +132,28 @@ export const xvsTokenPermissions = ["mint(address,uint256)", "burn(address,uint2 export const bridgeConfig: BridgeConfig = { bsctestnet: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [10161, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10161, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10161, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10161, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10161, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(10161), ...createMethodEntries(10202), ...createMethodEntries(10231)], }, bscmainnet: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [101, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [101, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [101, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [101, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [101, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(101), ...createMethodEntries(202), ...createMethodEntries(110)], }, sepolia: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [10102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(10102), ...createMethodEntries(10202), ...createMethodEntries(10231)], }, ethereum: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(102), ...createMethodEntries(202), ...createMethodEntries(110)], }, opbnbtestnet: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [10102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(10102), ...createMethodEntries(10161), ...createMethodEntries(10231)], }, opbnbmainnet: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(102), ...createMethodEntries(101), ...createMethodEntries(110)], }, arbitrumsepolia: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [10102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [10102, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [10102, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(10102), ...createMethodEntries(10202), ...createMethodEntries(10231)], }, arbitrumone: { - methods: [ - { method: "setMinDstGas(uint16,uint16,uint256)", args: [102, 0, "300000"] }, - { method: "setMaxDailyLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, - { method: "setMaxSingleTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, - { method: "setMaxDailyReceiveLimit(uint16,uint256)", args: [102, "50000000000000000000000"] }, - { method: "setMaxSingleReceiveTransactionLimit(uint16,uint256)", args: [102, "10000000000000000000000"] }, - ], + methods: [...createMethodEntries(102), ...createMethodEntries(101), ...createMethodEntries(202)], }, }; @@ -219,3 +179,23 @@ export async function getPreConfiguredAddresses(networkName: string): Promise Date: Thu, 18 Apr 2024 11:34:11 +0530 Subject: [PATCH 08/17] fix: chain id for arbitrumsepolia methods --- helpers/deploymentConfig.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index b55372a..02bc379 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -150,7 +150,7 @@ export const bridgeConfig: BridgeConfig = { methods: [...createMethodEntries(102), ...createMethodEntries(101), ...createMethodEntries(110)], }, arbitrumsepolia: { - methods: [...createMethodEntries(10102), ...createMethodEntries(10202), ...createMethodEntries(10231)], + methods: [...createMethodEntries(10102), ...createMethodEntries(10202), ...createMethodEntries(10161)], }, arbitrumone: { methods: [...createMethodEntries(102), ...createMethodEntries(101), ...createMethodEntries(202)], From 7e13d370fbb8e9fcd6c8e0fde5943e44e0b64bfa Mon Sep 17 00:00:00 2001 From: Jesus Lanchas Date: Fri, 19 Apr 2024 14:53:04 +0200 Subject: [PATCH 09/17] docs: add certik report about the mesh architecture --- .../104_mesh_architecture_certik_20240419.pdf | Bin 0 -> 1225871 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 audits/104_mesh_architecture_certik_20240419.pdf diff --git a/audits/104_mesh_architecture_certik_20240419.pdf b/audits/104_mesh_architecture_certik_20240419.pdf new file mode 100644 index 0000000000000000000000000000000000000000..3742ee0b6e8fc083b0fa6a9fcd596519f829d0b6 GIT binary patch literal 1225871 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

wUyY=E3~M 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 W&HCv~Dcp6kouJMeznb#hC6QjKvQ9s1p%v={ufg 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

luH;UdmGj@HZ@FcW?0=9{^g5I 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%0A?k+!vN#=tF^UC02Cn7$UsEh4 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≧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%0A@-{q>9|79fGpGR_kJB#?2 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

g2 zA3OFk@fDXwiWl)mBu?D9G*|vIHl>NFC#c1i-j&syxhFSHdyjtSd$XAGkG#+traJ4%hq@Q}XOe!+Rc$xcT=CXfh9C$`l;A0E##+i#W|k zPc=EU@Aq4acR!QY`oMTWhg)L1`F=mkluABItunA6$Ir&H+33h^9R*=?rHwPN*Y__6 zerLtb?iye92fF^xHWZt z=$(Nw)gNhJVYsj?BZHXV)oSUU0=)(0;Z_+bV=Gpkz=~xf#8Bi#ET=`qI=3FWA=Yvk z)N072nM#fHG9EoNbaC4ok6izO(_!+F0#)L}*b_-q_%2$|V1$Xn0=!$e9VRk_Dw~JbYITn%L&q`JS?N^2j5&Mhm=#Xt1XH6Lb;*#LImrUBs+SMA#}4wF}Ww zdkn>yYs&aWiy(D&S2~&IYE**~=gdimc|$0(;f|XjDjPnYA~TFFIQM6Nh`7xS!}Yvc z(eK;a)a_3FwMMszUIi{4@fosR31U-p`K6tSH28Edbw(U%z!1x}VJ<$wK!-d;fz;jB zHqT<+epv;%h3$NI;+6%s+cx=tr+3LMXpIu5;0%W`Y1auMqo0ABKg73YVk{K(+ir16 zO)t_*W#iYW@-B=wmsAl^pTb&it8H0?H+=;u5T>xKjK31>pk7V~`4iDFsJd2W^UA zuXXfCjg&YSck8>Btyz(H9@o;O1Hd^5(Fo7g6LAILYEp_IGRs^2Q9HyQGk(U1LfGm< zs=wREE_MR#v)w}!F0DA!F92Il?jOJ-j6?Cye{E&)na+&|XpRVUF=qZmMDhPc-ISmq ziiVutX3sLdPFEl~@@3G*$Z!aEbh-JwB)D&(CuNb)tduF`RofKg%?7T2HaZAnens7N zXkbS?K8qv+O_<=1BYTHjF@;`7x=(9pz?F{}^*_d4ho+_*BWP}kSDN&8zggjowzdX1 zj|zh`5CDaMYXYLod8RJ{0Y-y*vg=p(^t&R!+aR3{y4dQ%eAS5yvuha=e7D)c7WHGP{fyJ<=Ifqcbu@F5UP(ooiwA5msd^=tZcBG zqTdHgkDSBkO!W7)4K~Xak)hC9p0`+%a#;cmz7eVAe0+3Y78~Ik+WBTLb zYI_jWv7ze~U}*-dyHvr>0dxH>bim5Gm1YG&RGde(kH=V-VZ#JwGG7137l?ymW z1uRv;B+4|%7pBRBWma@ujuVv$mi5Qo-@3sGA)Zm_PcG4^DW&nP+Ts`SdnhHmLCiAa zq*+Lzbqat+N-~fVJszC_xKvvGVA*cFAgvMIRhcyy)`{C#Gq+p0xK@FGi5jxE1zImJ zLq?(Qp!v?mw>TaJ{y*%!bx>GK*6tnLJvao{;O-Kf;O-t=g1dWgcXxMpch}(VF2UiF z%)DW=eFx1e16p4#1GTf8>wZgFUlBI5+VrIrIbArRryS%@uaj$vkprmn8~f# z#Q30H*DGE}{B?i!QA+dFcve`STxG5kgiiLbwmD_G#BAtr%EY;vHXui~*1$ZE8g=*v z{iJ3A({-XrB%_{ibnkKjrUbT%nS}kwE$r3OXeWg^majW3m&HqwFAG702I9DHa_=F1 z3VW9t)W7SHWL@apEN15GF%%X++QKDRdV=`1U~Z`#E%Z{GY%?QbudL1k zaItn5fJ!@PxW~iC=%^d#aH)?kc}3W8^4pJGq+c9o`=i7JN7gt}L~LVcjRdf0=|;IV z!>CV3HTzEagqw%aaW^lot|JbgvLl8gtXACKH3M?HbKI#@8v-X$1VJoUX;MBwBYBaX;i>ps71T-IF0}}LB$4)Zww#Y^ zxe|z}Kxh|URbSi4-L@yhVXdO03Bk2)-xu91;_+%ohoED04eyof@sl+60SHXe24k)? zNU;t@KNYO;mx08-Gh!ZJ+5i6~m&v(m!SJs8I{GI(S<(AR_A;(2V2tjL<%jLwNPj_XY+9p5Na zpmLOx-BKg~{_w2tC3Dq)@=Ly#%q4e_THx}g;i*+&;0F{V#zz)jj9g;mtpkL*I$~L` zZB$~ySdJYs&YQqH_7!BcNl1`efEn6QYa*tt>hz_NwcgrBkFV604)%FDAKV{;F?<79 zp?yhM@L5$SMCa5w|Clt?Gs8IGZo|e;Qj=I3oF&JM2W=@XjkcWf5(cd=T+wo79z_v= zR|W>@>O%o_gS^gFDCRI&VWOi{YK%#rR$g$0dDnqXR>pzA#4Oz!#qpLy^gM788iQHG zCd9zNv6t)Ax0Uww`Qi`_qBWp1gaXMHL#_1q8$a4n{=QdN6?dMvw%{-a*@>2JRPh~$ zF})+ohFf5in7JV@xB3xSc;GsdTAqqoJJ0ibiDe+11^eD7g&J{&r%t~%bjTCcoy9#D zKI%(=mUmzLrBM&|@AdXlL0495!#+-OHk{##`|9eCj0Br-khrG*1ume7dxQT#XaI;)OM%K6e`7FbDIy4=OZsPj5*-x zj#Mpq!U-*Cyxz>t!^$KH|FkgudueZ$e+@4C5zl`}d$as&aM_P8{d2gC@2@R%l<5Pgnu5# z{Jm(=vi{6l%T|(Cf=~Lpx7MsU{~ExlrB|u#6cAcT&}{bgb71p}cw30k{4g{S5Ndkr za0FL4hYVj+MzF-lG|-4)zR^z#<}z(gL=-)bo6RBJX`S$4w5E8XZXUi<{LI;T*}8s? znQcoElz9t%JMRfR1+E|al?7FCuwj;%+tXp3W~`Wucxc!v7OSTZ(ERefeVzibf?UQ< zZ$i-UTlM&-jAk)a^EKv|o!h>sOe)pWuR5n&O{WrPteS2G_Wy4E8h--E{n;LA z|8HRLpE+uY2h)DHV*z$<(>WAIdpK&U(tNdJdH2JPU4#Xh zy|-__}|uJ zmcPu0;=de=e;4k}@~d3>4-wfvBKnUN`Bz!uAG`VYUi}M2{?jt5U*g`cfusEqyuT^( zYXM!Bzticz91yQYEkA_qKZSe$ta9yd8?aCgcf3k6l!f(2Fa9p_%k)#O zCk4XRu37W1yPx{48pdS>8lj3Cg)fw_?yVaBbBK>Bt|gxwZyoL)1Qy7)8t>Q25!Rh+>Vqqkli=cWw&);>KkBAXCadRZL` znF34M+C$ot;ISUhyZJ?|KwD1kg&2>n1APclTe^J3x-QdJn(bo*Tz&vOcsHzO`5V(K z=kUg+6%V8FgV_j?ME(QvOj|S{$uigcOL7lJ8@UT(MT9Ek6@f{zjzL9nv6{-=;>V4O zLI+7L-Et3(sEl2>7~Nx20khz;L}U4OsuwP^0({3XAewiHceU$2r>S$LWOsM@HAKvT zX%Zjxb3@Cx(InpNau+O_J71_K3o0M?XhqQ=ndwRa!K7L4& z4}O^@2i-9#if<5oCvQDQ|cY|ovi;x6Gy8sV2-kO z*-4@@GotjQ3Wby8$JnVxJs*S|RMfDOnO5mT2lJ^^B)3{)52a03KPl#9zvhdweiBi+ z`lD)2bHlqzRMFk-a$}dOb=Ej28-=D?#1W#*0`)4tii^A_buP}BCr);Co`$(uMW)bw zH=?+qN*OyNWmdW6t;Qakupy!4?GHS!@V5%rHzB=(!<<|BIzUXB*|rh52i|yWhrw4cEwQi4}j=FyZ9{m9qNWkIm0<2wc&vrURzCzeyi(53`+EZ9*xW zmErx?hzvRsZ-OZ=Orno|z6f-v?I#YZD~`rGrm<3jDl1+oTN;hQLXJe{B#kqVr!LaHaKt& zdl408UM#WF48h3yoZ&$x%%m>9UTtIx+0q3l8*e_F2x33{Te7oz*FLv@I-HCDz>48Bz61B`XykiLtl{{6uk?Jma!xfXi@diLb4usLeF z36Ji8BY9RWu%4nU#&scXa>XdqIJ|i4{e%W2>>WSl`!)SXCiBanSlP~S+4KlO>D-k` zu((KOrrJdr{t_9p&N6E zvWg1wQPbcsUnM?B@YUuznIWXrZ|Dk4F=IIKwU!9utgm!dc}97H0hN*L29n%W-(x<4 z8JwDyw^Vsv*oWZN2rs*KwV^BKcX05*)Je!n9O)|Mm0o7LF0I8Ybabs3wwTw(u6-*g z66oTJaxr4y*cB;gxYH89PVOE%)m2)gx-?g0Vj9T}2 zd_?3%WvO~G^*~kYk!Snq)fq#mgL=&Bn%iYZ=VUsbyaFQ?*WdBP=!7LDbue~`F4~pf z=Dxj;i-2k7d9~8a{`qL{4mK=p3W?I7ToNtqG`06K)zeop#Z$g6#WN&>c6lr5bUR`0 z2sC44li~79nxn3T=wTQ7ybE*ayAqst%;QBBnIo|ceUV!^w4GEs5^31S<`4O6&IXL} zF>6M4#|6Vx946!s6l2pTpHB_RX@>nSNfdVqChts4cH!(s6`8;7&)>*vu(J) zj16DqSqKwD*L~cCTP1C$EVOncQ+78eVa7h|=QRgTujr+i!-9oP>T>FrMrFNx$d_SV zPv^vv1M8Da+I- z3>A)7F0%$6I8t|m+@2#_QGh~g(hmejk6(qexnKiA2|{i>^sXM%Yru0R+Dj)Hawxzb zs%Zw9Ft|LHoJ2&RkC^8DZo>@T7&s#S5t>4Lf7IiKv_p`*QAy~z5i9Lk(@wWrc|_CTS-XKIsIG$6n$I9J^-S`w#h-QSAYb44{+W>fIuwYDEF-I!sW^ zG2#;yzBxGF;BKj-DhUpx%&1xr>mrZJBo zN`yMYK7b4oxhQV(0XOTqP|3*7-pWFdp%>uXqldu3e~5|7lPJ#Trdl5wCjI@>2NX(@ zhO-Z?+IuL|Sy(!QjFRifx=E=}UYe;&)VKAs^mJE3UU;k3=zM2H1?mul+av|=$Sv7| z*r3?H$S7GjcJF+!VkqPI@Wu?8qN@wUx?@PbI0o`+9fKYul+;a*^DS6hjCl%0GeiP2 zxi=xRpITF^}zJrqTNrKAhgNrZZn~11G2q``6iK29YX!cA(xAD}+ zK_{Xk9xMv=p!+?aK^QDwl5$$6J=&` zvv&zkRO|bLs&BK>aDgVbVuGl4EXQtz|GL(;E}< zCa;*z!W4+l>B|r?`pVa+FEhyHcyO87$J>R}IR$!$N*LTdb*LPj)Qlho4fX`k{-hCw z5^ubeSv|LSX%aY4T}Tmj9IlYlb_%JRnkSv72jy3ZbT?F;#ejWWt_s&v(uEKtYmy$< zMh=NEQ_MD(FL7IUiCLdpR_X_8{G;uR?Tz|+DF%Wf0cII}l^7?bJh!?gX(1>fmRWqwHM$uJPF@OWLQbjpVKQ~gP?^`I?~THfq!$n6HP^K;*VG^M8q&cBY;haD z^k72-*vi+m6XNt{;~izOqJc4IRzl>}7B+~#-+*iHO3wypg$$lwjuP+&FphpL>Hg_+q$?0y>Kg)k z;R6id{0rB?!UMiph^6XGB-77|tG4a1L^wXMvRE7;3heWzvz$IhuxI_c{B@37hq^#^ zpnQKCoySC#H)i3ILCD67Jh#4;B7_N#1euACyr|L-EvFb&D|EiY$vVMF9nc~ ztbRFcsCrx1N1VL-30@runc1J~icmR(h*>|zNwF}ueaU$@mLSNki8j*hxjBr|KO^y& z<4nBpvb&$9SXzHgyhf+N=8`V#>>Re-Aaix8)OcyP)cB&ju%NGShr4k)i5Y9Ke4S?X zQ!uH_gSw!ctLvO+t-5|3X^-}~xLE@%CThXc>nZjqMx7@6-3p3bj$|;ZA75xWt!|jcbot@Kuf^>fREv zJ|PKF~m*Aha82)c_@%_CI*#A1J|JPCdzmDqP$NdjSb=JSkR?J^-kNrR7sLuK) zZlnBS4fC}((EjKVzgolmS2vdFf3lVGeW~$v!B^jAHn;vqW{{`S0mEDZ9x2TG<^3c{hkf|`$og>WhVbO{;iZF-}l%*68w*UE7tcF z{i@$y(f`x7P=1-m{qvh(zZb6mpIEBDHuJRye%I>%E&TPL8aV%%_elHKvQ(#gEzb3) z#rx+I(DzsWx7Yux3Fx06Qh#iZ{rls8Q;+Fr{xYA5|8gw;O?&KgG{4HF|A-?0Eu#NO zk?ClDl_mbMoByiD2_4O!mQnpek-rD-Z^8Sn$lqJ~x7NP)`kxPo*K<{`iu}WQ{y#G} z{a;9OFf{IWMgCsoBt0MlM6CBml@mAw>|Zaf(9!%PW&1s8V`X9aNxJNie60T6Ox)~s zlRYyHroPrD?oC(wutQ%zp9hOFu45V@tQS4R(W5&qp)FZu<9yz9-p%l*zQcrl9eI(r zBGS_&qBTm2d+u?_&ks+XR8`C$X>+!Q^2Q|HojV_9^D5)fx_W#Wsa9fb?jGDZo(@l` zUVtR)dz21kvNPvF{~cp&`w-m+1{MAo0MhSEB7=Jz~3l@GA|(v_@~ZB<@^#D@?hZql5-M_Eyk2Y_004`1N)-dG5K+FW3pr+cs@A2ZFT z5!13F?%ut)@+B7(v#O>ZxNtInJOW%ELz)P_LX@Den&H{jr;xC)l{EN#o;#UTAoTt1ANu!!w_{^+H-kn>ErpukUKYe(_6*Lo7*Mo z7dKCKrfGIJ=kVf>fL+%eX7(J*cXv4498Zr! zMwCgyBjuztx5}STW~Hdkn7Q6jT*0{9eF3-lsGWdUT#t%!6;E^?FL|4WzlP z#eD~eVzx$?q&d4d-x^nwit^?ygz2cjWV_o z3+Wxyj_U+yvwP~X^(|r~yk+i6vp-wxOnc+bwdc2SjX~j)Km{Tl5>#_5wa_Nj{32D< zA}>B(WZ6Lh-*-e_iSzy?weFD5Bx>UQ7bgKJVCb8b?IINE^^!=B5=2op95xY!$&Z6W ziXpCwm|roExidR-Q2A3AaOBKU9$EML;(E5BEwiapp$`(lAC=^yQ&MwzT~ zC^|f!@DaQSGy@@u1(CF6$`Ht&EPVQz#+WESYM5m%O8>VgKVBlRXARRdW8QR2`+&2guX2MPSd}*RY_xSw4 z-Q~nMJ~S0Kp2*!PYo4aKz2ahgCM@Gy7)gca*v~vl{dYrN909ne2Ulmfx6>-Sy*TmW zgE4I-M6iVLgQYVxAYvv)I*WvQ>n-0X1}hoxhY>EroelX7MKb~GLn-J&H!&1*kH7e7 z8e%WO7b2L=PC~)Q*2ohVm(vp;)iCqUf16dCfNM1558MB+m0}WAx92O)nAv299s2yZ zzu%Ti>^LdAjp^-y?cKgpI*yJ0na?+b_Anyt#9ZuVZhNbphWw`Gf@$3MhNg^m#J=x< zS~2}@9L<;jg+nI6>iS)br`jr7&2XVLSfffaBfF&eGsB1AO~jE9MBW*buXS@C;RI*K zz-b?$$1m?!S)v5QH4%8H&`@mCaN4!g5gbp*!UJY^n8UmXkCY_t-w}F4Fk4;93iIop z@?RJNK>CNS+pWM2j0dWmnx`TLjxX!nv~9@(#j{Lf*gvBVjE8ui%>Zoqxu)FN;KHQg zq*oogx_P{F*}jZ$Si1!39!g5Xc$9|6PB9H+y|_cO_sGN2{S-CsbbJ{R@H}_A-5Oc6 zgYjisIO^~-*oEf~wI1(GML(NAT;wC8J(21pR+8!UXD^u#Bif?MOmpPhTubHC($-&P z5^CQky0n&i8-GYD3BGAiuV}1?fo-j?2}Sulq+hb#q9yEi6NksQQWxLsNPSc&BE&Y# zH&Awd*SiuBZM}rQJ#zejlJKn7LgF}O&nTKhCS;62@ze_DLqLiEsvIAK#vY`4lDLbe z1My{dvx0mYDWWQ-GJB@>8Hj%Ce|)< zAGYAP)x64b#sVcKy>Sw6Kh_)Mx(^r#T>fAe2b#rfkt{v z%4i^F_MdeF0*aQ(Y70a1 z`|g(1gczTHl~h^*1dW^(vpJ(>Wp~0LG#`K=VDywEG4A)&(I)IXRrnw}%9!bm=b1{; zAa~;<7Ze27A)BY-oIzY10}{p|h=YNxGax3(=PXkQ&6kp~?60VHG;Q$MqJ-v$p@`ZH zYQfJ35`&U%CM<^Vc$2^2Kn|w&NdXltN!XjGZcYl*hktc8r8buU*)*$4DaWUKE2~B= zU3hpro+kU$=?O#-gk3Ji1R#I5yXGL%!l|#$rOJPowb;9ss-1`UN#?V0oyAZSj?~o~E2+&3 z!#V2?#lKyYZj6vrN33QbpSMBWd__u9Js&Bd@MMp5no)z2kV-J|)NZDGr)G}L;vE=$ zV1XYG0^+6DJ-a)bsHDYnYzK|!U4l=Uu(KkpW=WKgefq^Z_Xd4V4NA-l@$&>H>|T}e ztP>Q1Le>Yuw}q`{q!rF_0UzgTpx5Z{G??nEGYp!*w;X{P;JPzfy&7G9&fZnA_JUuUTY zGwHAZH96`uF-gwMl?`K`o6~ahZD6GWg3l(0iskEJWAG=O<+u23Hj1f759(t}s_8>_ zadY|z@n+~A-Ay_s5YvcIasa!Aemm-_!C&zY%k|D4h~iy?9Y1%OFmsVItHj&8b{SjT zc3ZI2G7*_)yOO#ISQI5F+I$697=6%fls}jmjHuMQ3KMM^yi{=1c+YKkJd>)pu>U>=5iT?z4}N8QwU6qOpC#hVM$ z$<38mFU45RRb1yGf&f@Ll=D-F{`k-+gzkajJ zx;5Wsz+(U#JdK}R-Lphf#+|dW+_WD_QfNukYWRp2pFe{Q*9Sw`tDr`{G8j+Z_oB7Q zHGC}@RynYVmwf&Uun^4FeOath%Oxf!Qa4VCX>!Z!F49gwjCG}9WPAY+5hp>A72hsh zy^N3MI3)_4oy$Ln%LV2j0$wfmDH~!wCFR$_DSBSs>EZ(lR3wXD!m}~ z&ZqCq$sP0>Y^O#dU0<|BdkGf)oYrl6i?%!ET585IV!c6rwV$~OX+sMwUTaLD3ciZt zp@DjUfu|IV&j6%D$CQqqlpAqGuVIyKmU!zmdKGxZ-J>E9ndB%#iC1!fazkPdJ!jI4 zws;9PdAiB)k*NZpf^t=)Vn-Dsphj8a0>DAvC!%!OlKkfBich@S3LxF^wpxIF!k0j5a3BO( z;t0aoNAJ|weKQ#S1&gC#)eL;eJon`i)7By>{K{JqjEKDx@X$`aeON38n+u{%m}R0H z38#Sp(cK%Qcn3W0)(*dcQN)7F#@uOzyS5F!>?|#erTwfxIjmDl#%q8O$eCfl02;`7 zXJEoC)0dnb1RkjS?L%ib3r>J;E}z%ykv-b?_(a<(?E#fdZ0fp^pyT(8GA!*ly%{MV ztTZU#P0mJ@+wVl6u2`FBZf8UQEYRRfV5A4%1h^JP&Tt==@fD;G1Hn;45$=2(h^ejLRm98oMW> zUYz-0Mh>rDQ}og1pmcuXvF4d=?gP+i zl;`MsMCZv-L*(l)uAX^99@hd%p~mWP7Gf&(QvRc;WO1-*Ayu}?aa4o^zJdgaQR=0f zTLCuYv1C!0e#Z%vT_jc!rg57n%aZyIIt(Z9k&17<02T2R+aAl=L~ND`01d=!mirqD z6ic1N44&Pwd)+mD>NQ-fazTVUGWZD}zHNFf4eB!;TWV|8$Y}?vK6M(imvy!}7x8P( z6XM>BBgO7%sTXF_M}qdh73e!&KvZu&jB)hwAFeub(oc=i=K6Y(h|gcoeUaGe*-VTY zZB_XpENaZ;PQrIW08vuGJOH}bnpNoV3R7h?BGE6$Koz9q)oyI{14e911^09V>=g8_ zC0Hk}YzdS16oQ{(w#xdX4p&9nj!@x@eT;FA`PhAgv8}c8W0P2o3=*bWP=P`i=@&k0 zU}h{kEX-&%(vF!XWxJWoovFi4nDXV7`4qLPv1Sw9^egjcatep;9oaG>QZQR+IqTkP z%*Y~o-E`B2nO-Yr_>`65WJChb+9m~@GzPnC>8e+2$18eU*YzTi=7$KA9`ZKShq{7q z*FInhGpn$uy=LsoUhwcf!Zgfa?{LK?nD7CHgb5!j5LA2NB85}}s*s@8c&`=8?<22EfLLuF^|ewx`Iv?yQb<3z3c2$2zh`)g)R~zT7|Is~ zl^1f@4dR28fh8_M@#(BO4UyZG!i%P`MhRmL@U^fCV+9IkZ439n;?#$S2Y5KGZSd=? zz8T>U+X9%jXGE|pliF?SU8h{7T)z|HIFjvqQLf;DCKej-%HttoL;-E$s)HGC*5)b3 zOmBepm}lm(b_8fJ_t=R9(OG^oQuC&}6(G?Bx*z7nz*qo3!?uQnO|dZ1yU&JQoBUW= zTed|?+r9fu$s2Ih<6+36lMzI0EhNu93U#$iRojj)RP|)MHglyk6BSLy%+#N65Z^F* zHAOnfr$DGVnmY$9P7qL)EsK(Qf&~I|*iDrTaPgl6;u`LOD@0K^4+dBx&k`5hTp=Ej zlsY2uks8@!0mnscG&80Mx3d-0lhor@PyymP5_Ykuq5_1oRO*M<-$m6zhWE)|lM#^k z8w#U4SW!nq*XfR70_p8w=ba4WTjDOXC{KT6yKf2faFPQXY^o1u!M&zZ!neD1l?A+> zhMlqZeT|q3q22M^P2(rIxs8OU8u>R04Dcowum(UQb)VEMV<+ax$O4#Q0~lQcpa364 zKQeB7=yDS<5>adBDTWYJLl!n2kWe$5*UZ9Wt~5e*{`Q%|5n{MTuM$L?l^+Ro77Dpn z7}{q#*b>d$Kq212B6bfp37mg!e*-b47)rrLSOzd8CiBwHH_&`Ve(0%FR{?M-A?6J{ zvrR}50pE~=khE?fN2z@}ZKTD7PrVqUPmfDlPb!jN&UhhB`vhW+Yl~Dla zv0c6eQ(3W#RWggcaR<%WhD47x()J>eXQ5+1V>S(XY#0=WAmz(P1v+eDsW3oiHEcGF ztc~^s4%M^-NuXsXg;cgriX?aDwV`(-22R-Ik6bXEz%Vuw+KK6wIrw)6socn_(u^!E zDrX^heZ1bQz69+4TP8;<6{P7XIh93#%MvCHDae6Ne2USHXJ^vRx=sQcM1(I%noHxV zqga(|qKYL8p?!f*p#oL=ASLYN?rLF^iX}sCm|&mgF-b^f&;|E}hzDq< z)j#=T52GgA@v*CHF5L;4LR@+th8k~#ab-+@ak`v-JJEilrf{GvZ7}I@HE>f9Gibre z_~{uwXn*Y`6j`w*bpLwlZr@8o?$zGV!06za!qzJzkpE_-FzvDZp|2p~u_*ZFN-y?~ zERbn(9|1oNKNWKLIzqyg!0^~1h}Mm3TLimerd%i`GM_Ci6wVdjdhnrnV?Jk_<#0LuZ-5~@f!i|oUn@H7F-c#nuvUTxBd5&o!`BDHxGeTow683LI zFN0POc$nJ~J{D7GsIH5#PiM--n>f9+t7667+lETOnKry6*aMYO5T|sV?=Rv1>fsK6I?mpAWDq`1fzHGKRRXRpxTF&G~6!Dgk|+lzOOrvZb#^)li9PY|T(O zN7S>Gzri+)gme?9K0Z8D(zGEi8u_?;Nw9;N-)BSaM5}&>{UuQ⋙{7M9I$Ggix+n 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≫( zsL5EwoiN)`lS0-bJtB!WCMv)F)w9(|^v}vEk$CB&AbUl+=7~;TYEC@LvxB%a4Q4AA z*XQtXdZfQO`)s1}v+WIkr;i7NkHYWArNzH5eR8&4>A_uU??tomFgJp;C8sCDQp1-< zYGu=A-wTD1;^fK)=F=It^zf+0r&M1s(ROi1lN6I25AhT-6lU1 z9NL0Yn3`VuaL@UZS&d4CuOuVN0bU^!qr0b*P`A}~Hd8?O26fisHgZf2Y^m?R|GpTb zB!V80FumAyD%JzP``zyfBl^T0Wulv__3PKqpFc-U!tz6XBVC~UzGen4 z>8q3KEorS2q+hZ0mf7;>G=Jg} z61AG`vG`B39hG<_{KBLOiRLdA0(|)4hY}|eHaY%%@~*hHOC7>Mvz20hO^d?nJqoCv z!@sT>rb!cK$71qS{QbD9{G2vPUTIAjd*XL3jrdYmOd2>lUb7FztypT~8l?O1>S6ZG z$%9MHk6SVO$WmJpJsEe}Qu$XAW*Z)VXSRAve@(PKu2o#fQr+Ux5|2!py!6Oyt(M*u zzi#qu{ClDU&o*$WU9-Qh`9iu0@h|C$UG&#PRoA@kken5eLK2@CH+fRRY~kdf#x9?D ze0{aUiMM_lPkuq87{vxjJF6|PnF;IX*x9xu{<>7))dE5_m}!Esfui%pb;{kMDgiT! zt_4P%Jum^DJ$qJ_%={4O;oXntl|Zf@3&Sd8hUjw(zIo`DHoQn zqB2W0iQgNyD|}0$SpGL{7(6^2%GpN6kIcS0U5)ghtoi)x(66i&#o)w0aAlc^Ni{n+ zR@N}?jY0&i3T`id{M z0sjV!~uPueDVo)>bGy- ze(}W@q3cxfwMot&-r8FrZ&3hExVgDer#0U#FiS0*&3A%cq&>3;gYWFr>Tr^);>2iq zEz^buful}fI)U2RjK_I{^Nq`8IPpFAFF8jm6lXMBR%e){RBymMSqPG)N| z`{lz!l_p*7#P4F*0jO|JUKdv;ennWfxLe}K;}2)wb@uH9<^ba>NgT2CHBP5Q$?1MR ztnTW#ssQDqNN9C z`#gT>QeP!LNj#W-Q9M$UYR|rLeREd6X!ebXUnV8Q)rf05`%C;`-2AxnC%-JcCGM`X zUta3}vpo=g2V0VGR!?MUq624Nni!_p&(n3Atx3A%c$gBkU8-2Rw&~B)1tv;fS%JwL z*Npz9?@fI3>LF%7iEFY3@q1^xG5v+ZT&uCqK7an43gnV)>hN#`XRDOx>Xlei;rOo? z&Ciuz5a3YHg)b4@Awtf{H1z~AdrJ#d?UPSFK~bS?s<@NGqky?x7u)sdJ`-O~gwYR9 z&~d+n88+=4&`3dJ!AYhn#C5?=&pTE^jz|iSP!!X<5+7QQ!H4Uvst=N#XtkVpWOVYg z6R?UEGhrpY&n!Zrtu{h(*NAJ5-I=D>M4w<+#nff^9`qarg8k@6KZ-3;SJ9>X#C0lN zLyAWo-`7Q0Qj@~Z!)VqQFJ7ddZ4bKGt&c0r|4t>O#n*a0vntk9Bm4rE%o3mW(jymD z=5Vhy#U#}RQG5{9*Ar^k>|3f9IbD%HiC_9i2>V}Rf_}r2$nppIW67KE`9cJ?@3r=N26g1KNF1#-^=e~X_q~Bh#?5&8(AZ0HB)?I z{TAOYDI}Ri)XrW!7ARNIfskF5lsz@L-osSvj)I^O8$WIC_{|`yg~25tE(d-U>u?MW zl4&p_Qg=C%V~}SEK>T@eMxb;r8MJ~*(kpd%3*;KOoAi$PgB%V=KEkcGySgH}lY#-5&tmVWYGmVq z6ml=2?He>tIl913U{NJJYQhP>vL+920xOz^%1z3vmY^qO?^?`*DPnuqVw>RY`MB2U zf~a?2kdFqbg!_W(u9{`V;TQtEhPL3-PJ=x4;Y$}Cy@P7o0p#i==VppwP_828fK)2z zM$7K&685$2jnbh5O_xk_U{Dl~&}M5PxVR1MyVWuFDo5|N={rPkH~g&XV1W5d zx2tE*o+%y=^-tY)6Na6ZonVX>yoj*zaGFkviG)XF$E;0IRs_@#P}NGai`8V za5!Q#SpzK{6T8>76pkUaeOJ(j79#YG(>K*aj&D4}?#L-*%J?J5_Z_N%UZH9i0Rze; zylT5N<`sPjil148Z)BzG8fh(cR|)jrBP*uaC=vl$CoL^5QPI^hb!}R+)nK%gwKQAB z5$0jsmHO8pG(*BJbaw&c0y0Mg@~$S8!{Knu0#Z?wr6KM#w*k5$3~da=nfmtj)Rk(mqb|t4*nLr#ssLk)W)&p* ziKV&F50$B0^J6{ofgLa>e^YpSXxyYp#+BpoxYhey#%;MulK_<#8iae-WeU^^@=ARW zW+)}?48`k~k5JaxF}~%S1SQpAuXRUnNeH)Q-jbDEo`hs_rAJnG-l|NX8?DLea5q;^ zC*DnD`uNrJSla{WV_9hB}ri)ZJLa3H`)+ot5ap%Ww}}9hhqvQ0JEqZ#i{h9Pe$A2;L61z1bb^kJ~hK^sdVp zTsju@cze1d**vGpJz#Vu*^`${_?wx|5ouPy}=WT=@E+ov!bkM<*y= zR}aii^7QG`H9EF*yD4se3*Zff`f+F!7P5XoL{L_^0pwDIv8eSng72MBsc^>-5D9Ee z`DaWhSHZStDHDgWrS{czhocLa{wCk;>iYUxtVRmKLPsF}PB#f!Z)U$t8oEm_f_ZaP z?`CQ}!UL&JH1R~hYjl^7(9>ecO{FxNW}v4MSenb2HmP3s_Nl2wQZDlM4mSoLc6 zB%7XBs2Jua+Lc4*!^LIOMLd*sb~^v*)2AXo6_1B06m=#$+9K9F;ovP)Wp$^1RJgm} zDesjm@K#AkX~#MU&=tESk)DP9sK82qOn_X1j_T8(I2dr@T;+%0rqApJ!G6YQpMq}N z_|83gS7dm|X|c#v7dGfB& zY3gwg9RhX7)$SJobo^r&p!&qEt3PjKNZB`v9*e5hyUqy72Z}TN?^%;9f_zhUZAkTu z6LmT!pbk*=`rF}X01J%Ar2v7SpC2|Py;Li)MQl@00LUYnnXXg}=^h<#1f&q@T?@wy zT=A|ACONX4#hU?W%{dy9(M1V;VNsh(w6`YXi5kT>vP?n)M+~!eRE#eK5$30#8cKnzhI@Hlg4sAF!gGVif9eINzciZ6Y}l5HQupFJbCg&2u{10r?ARs z5~=Oi(O0a6Qo3U`5-4)BFevhgq3EFss5Od82%Dy}i;^20uz9`^b}1||#p7W-$jg^6 zb#=&LtFGFm3R?IEWKE_P$XSSBL}wbD|Bf0MYl>P%8yk|Htmy$fZ zs<#zZG)d~#G>uFb-9;r~%9Xc9GD?RIPfoBYNd`r2Z$L&p@6$GQ7=fSMK17FihsLwO z-pzZ`98I3rZ3byB93gV-75Nbd9T5_YtCfK;el}C%g-${nS3Dv)G@Ieg&T!iY$%G+@ z)P38FCWt`Iv3IXLJt-j54->;|JY6X;TS2BbuMrFVSyhfDNVIC_}1K zJL+zZ-Y`gqWqhe(aar^F4uMs`%hTQ!aX7XBsGSTg?BbV_56Y`dfxyfW`5G_IH3{Q6 zUO`LX2OoT(s3EVIjT{r!BV>vjae_5K5swHigdE?z+6axnqf@!=@R}@iPf`z`DQ^>j zFuJQbolKocdC(yLd5-a94TU>->YB-%ixTZsIwtV2%z-XtBBPfYi&dxx1`$eoouel6 zn2`0tpwL(XHAx2e^sY-IP_37#& zziyG(GeU<|JKK%J;jjtp7jiBhj>!Z%PyS{dx=R_{J;NiRVt|I`pbn2|^(xQQPH(#A zRAq+Z+K$*?gErP z9#5V;vDvybzJEf!on6?#@N?Vg9){*UixC>t8#gEPMN~X4&g~7n0c$`lMnW@tX41MX z*;mz|A4SU(rQ}^T>)yE;V8>^M+2_xnt4kPnjfCReCmSL5#{Gn%Zvb-ltzO6u%Md~U zsB>=JbvR6+3o8+QM0woS`G|@uKDLkAxwcW&9p0W$!G7`Lh2?#D4Kd4EFftSaZT6Cv zelK*BFk8v>;NgWqD`SP2gpdiBckeVpTPZ#8OT=qqvo zS_51ry=$=rSlAgI4o7i3IiYF**DUb5{M@GE3o*-BPWg}44X0;jhK85u z`dY9mFx9&{1?1s$jNOJ0*g%lbPPKmssrgWdWtmVFn6&g0zLZ5=Ac2{+3C}0Mileh) zJ#s~f``h{1JWNzKBCXu$fHEK|S^NGs>nGy~!E}}d-7klO^Z;Oa#)j$CHwLFtcQ`DA zVOcrB8W$n7hUKtl$PGC2M;G^;$;`zp`R*0hB8*0C5H^Arkp!mK<``x(tg6S-gKl)L z8zRj1KAc-PRs<(DmaQuW7a^0Qm`p*<ek7q{{~52hYM#Y4*Tw%VLJ8Rbt#F^d2f@JH;2PPF4OgjG2`si)_9(< zj>n@o7uC3Y!M;qtAl)5(7=BW`Zbe`re;g(NEfu;rsr8U^y@ef?CPB4J9_bpOI*z!d zW}18tfkWen&Cfwj+R(#84m!o-44FY8n0vYkjDA){{oi}5*u!18( z$1rRt8;E+&1n)uAj;XRvbz7CZ-NHtnZd?;PB@Zcpf4my%$_4NpK8 zcn%#7M{(rSfLw%-;T)1PGoXx#w~BAUELrC_)eOvVm+7+0pgiLTPwYNu>G629;4~u9 zH)>Mop+PT4^|B4!#?(gXaXHD=V7D`zQ}KAFQ8Dz8R6H)?RDGL|jVb5ME*68TYqo(b zt-)u02y_5-8pjDRUV|E+GyNMyzUgdJlA8<@bx;wvrASQrAQgAm7I9SRR#B4NSyo>i zj(iwDxi}mSHF$8Kmr;Y24wV&KGZepk-8H1f9r1<;nh8m4dYN3BnOR7rOjq-&FIofW z{5et!-&EnyFVtFOqKQ$Qk+`V77|Pq1{HP@?-*7lZtjx1IUii|LE)Na#@Uy@qOVRdr}k+h!5izi)N)#hzD(qd2w^$iGQ2ulE}Lwp4r;z2C99s{{A? z0u>gurl04zPXZaEZqbiydbjsix1@7Ad`^eOF_ zLyf_$E$3nFE2llLsSzQkMJFS2#GonLXGnMCTb5)T-)J*tLRHALO@$>W>L8C}3sXEE z(xfO3Bbkrer$1uCI5e|r4TX&XbAUcSIj%V25mlkcg^za`m&{0+i;&5}Q4nFPH+cYo zd|>_;ouu749o9GC{vqSB3Xz2J?@Li$H%DDDY-r|j0 z|L%~Sw!JIT8bbSQfj7W03tld_c^Bt{O}{A;g4tiBr1Q1ehxwqWbhEP>nd~Ts5|$;% z6EcMCS?p)>b%^S#7=n<=R%hDc@I8C>%EksXi$L8zU2wq)itJKT%GoYak|KT}_+ElXiSklIp3XcEhE z3Q4i~Dg2naw>>>zc!g(HQQ0=U+a2}5gA4@qo)40T;9eVDVb%^GswkVh1LHg&&dz*^(xYguuk z=>VrB4}6=TdmstTN?1f{?GdL8(H_;YY&6hSN-^WuJS2I|lP6CUkC!rSK?tXp0FDN0 z+|ea|FkY44KVjBpg;(@nBJa zj_C`dEX?_tHJOD3HRy~>nUoze%^CP{qX-iQ8O9th)bj0<`?0g7c9nt;yw{9wUisp6n2u22#VNlri1dp?kc>kTD|ocs%Ov zaRhWW#@xQUyKBblLc`aGVM^#V>EL-54Q^bv$ham>`3)!&h zSvaW%@799qo}Z=Qkzx*qV_XO!l}@J(Pl&V8yEJVjq9nxH14TkIDl&tH_&dFO_l}f+ zfBBbxNh6hLn4wP;wN|{2Ey584hgSa1w};v1#kq?%tJkkzzkK|eanbHJjgcUadgO~Zdwun zN{hh{?xD_T#_MLaf|r@+^x&K9rje6v6RVrDLdRJbk_IRq$3hbqLERMP(%9iiITYGm zsCBAB;^?twwH#c_a#9>ZbcqA7mvNg`hY#mRi<70qYz|h`iZ1ITnl)%SMEwi)tym)q z`XEtTR&$&>&Vqu%lL_X7cibfS?Ohj#!!aas4rsCk>j?id390f~&C_(g6R#~Af}PM^zWv27e!=>@e*HSOM2SDA^cCy>%U}NTH^2D}e)*68_>X`4 zw}1Qk>#u+JyWgz|Oos4(_wF6u{@?%o-~aya|Nfu<`JaFM;~#(Zt6%-}r#}skU`w5Y z`k?-Q^;ds|xBuY}fB3Ke`Y-(QH-GatJhFumc8VFYrUGeXlK$m~$zHFG$wwGPUbf`*6`(!e zvazT!WG5Y$pd)1GGbqW!9Lff(mqy3~U+^eRA0+p~83?o?7oQ1bQQXb12BaH%C9`ul z9DPB{l3Ed!O=ow_T_P|>Q_?h~QxP+#cjzgnGmd2vhKCh!5{Zo= zhqZvlCGiox^zm62(2F3CD|FX_=^@G@^y3|CxuHu*6{t=gR2AIFFxKjm{^*uE-fCft zZ2C2A}}U$%LNICXrcMJ{d*AJ{kHB%?`1+a((x^-^Fy2aJ;bagmW4;%C~Rd ze*N{=|MNfp^MC*Me}DSZpMLkd-^J%L$-XzaR1Ld}!FQM5x*9)pWHM&w6DNx8H(dwy z#7pp-IW~;g1@t0_-&7a3t4a`R!L&7gWl@>I$QL0q2}M<;lkhrLf?M#0kBY`M0f!p2 z#<=e{5niTyhd3OL;-D(KtFwxi4<4%Ug)Uc^yxX!&92a_s-y0aj01olE*y5yaX%HUpqW<~geN%?ZQ3qqS4n#y zJJQ&;eUCd4nr7UY#G!y(!RxpgHwg%8pXv^WV;0xf*U%n$Bv)un`E*I6106VFa8i^Y z+~Y;6BqOqZ9~ARZ@y#O4d{_3I5|UY|BkM!kRQj8An8!;L}m z|Ni>dzh3WhHd#R&h>LtV@D$#TLQDk*jRNvn9Zyhm{K`Dk2?4xUgs@qT2*)TO1z$&V zx5zYgI#+{W=(=a6>&B((FC9nCOEr0k70shF3Xwa()D`Wg?SmokI7=u-9W z-Me3%fZxCS-R~|{7+9Jl3~5xbGlff7$98^m!pdZbjtQ6@GABOkY}D#m;Jx|YcPnEj z9mXN9nE2W2V!AQEN^OMeYoB*;jxl1mH{b3V%DM&HDZfa}nyaVp&11*Qr6`BlSgFzW-|I->6PZ zBjn_2eGEN7E1y~rQKaV_6{Q5VEj^#aEc9nqEUOVsL%dQ^Cw-_2t}oztJnmCdawH(a z)8_2m03ZWvcPx$17(sV!a^wTMKX3d!&7WgLgvo|<+BnpB=u7S_szW`0AvMAfp-ZPk zjUx%_L&MA2sJBZ|glJ0*al2AqQ?i8hW=ZZ=bRmn2`t5Ij`}GN#_wtIgmEtg?n>_h8 z4I@i$=b&*QXDeABA-jZpi*de4&(G|TPhuAC0=g11QBUm8B6J;ezY#|b&_ft&vxc&P zNlWRsNiMAJphT^j*$twed&izfkVLhvj}^plmqdw@_(}v6vbXq!nUx}Oq5INZ`Gf_|M z&jJ&M(b-koOYe)FpS&{ju8xb)L%5QOL!I=qFEAMjS|n%#EUQtY%r=?bayG9GKswoY zB$_8yb~w@qeLvJ>Bl}bp^1-`ZdY#$XP=p=5rFfSEe(`jNBs8-&Kf|L_?V%@|5PnWx zgg)UlQ$7R9%D}oMzc^|XuU@^%R|v^@#Q@JXA*GmI!sViPqg1#?-5id6!lu|)BRtz~ zl1Y0d@-IVq3&y~6J4)9|p!p2Ix0%eb7sN}m$e3ai7u~F^3gMaEYJ;~b(8r8NqH%&1 z(RgiwS8O@S)*YjR>9?>Rb#nmwJGbdQD?Gg*1`5b1J8DuGmeTUQ?QeW|+0FJg7NH@- zQdQ*BF(p7gc3P*&v;#@9)RRJS9B046D7<_3?&m-M`RmuOGpkfDuVN*Ti@xz%b2#jS zQpJ_q!#!aX1lZ~%w~S2pa_ZhV;F}Vps1m~y6nAr^;VoMq z-WA^5+!PmaazUn3LNI)7t}mJU8zZ7)6{crYPI%7J{1oHr-QC@qIV|6gg%$qv?%lh$ zZ{OxSl5tt(#MfLz#-0yGRfnGl;SUrTT}@DC4jZ<^(HD)CTi)~b4YJ+?6m){cfqg+8 zZ5jr`Z^kRn0mBj*h^napkH#H<+^(KRx|Q zV}yjU)+7vR#9F>F3_2*tJQlkB)JT5Kd-+R;506L~S8b->&=IJMbEAY&KvGR)6nP#< zkiNbTXGtv}zK+Kuh2cfRK@m#-;Udd0oN~QvJ6J(EC!o;is#`VW$C!+A zI*JtG5_iM$Sm5~)o2e<{0v^@t8FQ8(+C^-^$N@T*+33_+*lK`r0gSMyeJMabBIdH} zVt)>;j#XzA?^!Mtq{Y)Qa0Su!*jFa24{=;IB*fM=A=5oT0u|MRLhsF-*qQI#L-)Aj zaNmczXCbWUuGw-MQlkMs6>}~Oo#Z`qX6urEadc27_ev%9k3rUow(_rxw)jv1xjfD+s&O_TkE`>x^-re2xuFE2z%+n92O+s^n z`2P35KfB84yiCDgp$t!s+YH1*Iq{#;5IXmQOJ>8er5Sh%R{Kq1 zG&zyfCVH`yVp1s{4=I;*%9TV7>x72nu2Q?WWO_@A9iz?d4@voYd8DiXIRk50_}7D1 z49y0`F#$P|6z;)AfEjo^9=S^vFZuR_vc)>uK>Rt)3ePqe=svMAC+ctrDR*>AxLgkE z_DUv%WlmU~Cxd8!Zd}?GAcr|^430aUN!n|VWF1GJ=v)P6LGv{ujB3bI-q|T^%XDsO zV>)0Z83Wkhbs=(mGU=-iWCo#x3{De6fuz@2ld3ZG#+fYJ>+5Uz(?zC$HO^X>LTI>f z5Ew<(am3)In|fAY+SB(;SAw{%sgJR&{~lZsLN_^s8@e6zO2X@KICS6{xvC-|{Fb}D zJUs*m=aO@md^3+115Z2b^hE^AO7oZLlb#w$B5tsHp$5tWAYQZbx7*G+Z2-SOqeaKa5 zamT{4APFsJh4HG63pyC*__(@pX@|(SNty+(fFU8B92~ zJS{^A+cB4P6Nv!`1w*#o3EAOr3<~UGI}govbVL}XYf76M9i;p%SYTQEA*l-?c?w<` zI}#Yh{7atIJ@`dC9HRhB^7i)jcsyF>mvC$eq=~q>xoPG@%UH;=A(oB7EL~8l+bmKB zkm?4APMDWIOU7whbQLdkI2?!5>cb+!QnD=T=tqh}V#ics6mi&zHXO=9P6HkH3$v_} zu0dzO!K-a1Cqk9T53Igya?FCh{iWjO$Y6jmDoZ%OD;8OY!{O+Htw!Vt-aDapEye(5 z0!}5+`OPNRmiX>B4Rai4k|B3TmN8jWmv%?-C0$E`k$Pa|yFuKqGC1mnK zlY92fDW6Wh{fF_zoI++5+EI{`&BWnwI4(j*N~H!6&;K{7?B_Y4_b>O^vYJ&@wWPh- zM*+#_-t6`Y8W$5PjeB3lCZOLkl{AUr#oP`pR3SV1&CLyot@z38!6XqDfstjT=cQcA z7$CeW|JGIbNZ)7^s|f|c8*OS5VTV&^T%uD44S-gBRpVg36`(9PMGj~mQwtC}z|aRq@i;AqI$bm~;wg;VRSXAx_6VJIOMJ!@ z&t^VOt0p=PKNUkSdxYAg*#@CwVaIxsPpQ}28-P~{Jp1&nOKXT5ttrPg34YH^WXZ7c zf-&P^JY7yX=xt|xbo2t&1$WO;1baxhVdrG$aO5D2$lLIt+p><`64XXa^#&C!NK}QQ z)y&+{g`z4G^edok!GiaQT-0K$P0herFaYzSehVi_y^8Gzl37wQTWBYw^N(U*3tc7@ z>zxd`gu<*BZpw;)P+4eiRQ`nQcAE^+A($t<<7IKkMPqzZKreAQ*fE>$0c!D;Mi~5V z(4mVr-Mwq!(10AC7SzR#2zP%SAwzpWlV;zYws^L*jJ;9vETxg|p7~jt*S(#UH|6ZHJ%}yZKEdxENY||)ysD_7qA>W~*Z6+WK>38SXV&J~5_A^DEtWLGDM(@oVD63T1nf>KTS0-?AiJ*6O$< zsY9s=4E-v9yq1gxIFe&Ngw(aPtu5IHur?tU$ci7of^6z;XmU7efHpL0FTLxcgnjQa zg8tGFyhGG>GZ1>uouBj_`6$8?e-^aKQ04OzrNiOSA#{xxSHY_adNTA<$;7v(tk>3~ z6ABhMDSU`YHOjd_2XVdVOLpi|TaRZppAcwTQ45mms420izP0ZnFi7@ui zucyy~w~$-)Z+AExX*6Sr&&lE9a5x-1z~c1kep5C936G&E$T`5Y$T)FVO`^oRY~z7f zmx5z~-fNcEiMQ1|UzpEMxRkpo4U~2~9%oIyjJua$DE#E*^^!V=SuwQdhQl!^=;esj z+L2_Nfl)a088?oFZnPT~R#0h}zM;$G4u^4&WN(Ko@t$(GHmEj-K?jcA0y`=6B2Ee8 zs!>OX_GmV~tR>{?q)Uk6670tS9)jr3Hq2wfR=Q`RvoL{3W>g?kr(x?1MdgMa=Nyhv zFz7N24L-(0cjXpx!)J$(;#;vEm@eA&A${XstvYw~%BX-torW@!rP-gZ15 zE!*oF0O}cZv;2Ng^OM^L>9ab99y=TgU?-wNTh)oT9%$~yo@Fg}?YJPj=28sxSuh2F zE}tMqkdNn(1WFhNS@p+ z&6a%5Ku9MkL8lZkx{8h&3Nd?qef{DDb+i#9aeNaT3*y8(sBNk-&_&oN=_kL{?y5wv z*$koYR`<(LYDdNM!lShOW4D2NG zhy10FXOddW<9By=I?EW7QI@*w-VY?xfttX?Lh3hO`1Y;C8iY1vvj$5u65%($e2wd@3InRK1OX!dDxH;>|4^pfATkh+9_Iv$UZ^Na?K zzn?>pVhS`<=vE>xG|7&lc>M9>$GkL$q*V;G2s)i*3~QXP#t7;T<8*%3NeN+Z)}3U< zE~h(5NxyY>5zzt7w;5YB3z~guFbEYyrkUDt2$-)hIX6sPUmQHtXBvfA$XL4iX5gyw zo^f-+a3^Jhzzza22vtEX3_TLzEYLsW`W;mQjUKh_nc~s6u?ryfUTx_&5KXQ?j>+l~ zrxS&#%|$}qpm3Jbd_uqL3A4Hkx|}IOr=VEWa})6({f@v~eR>bYfi=YQrJU~Zl8Lt5>Myxn09*qESK>$WGM>cR%6cwBtObhH4pi;|B~ z@%RSNSUA%bjSjag4M>lP8RZ7^zUUb7iucl;aun^wQ4dgHpwZRdBd9Zv;>GGH4(iF+ z9CtqYj1+_HRUhyny5;y;wr&oau&_;I*)l}P+Eq3Ek-F!mNr0K!n1yGPx8&lRH>HmVm}$9M$WBoZdPo>Loaz%%H#=p#HN%PYg)`X?)&7Krtz&@p{&SC+j&KGcanD0QBf-UqT(%ns<1hk@=hLc}m zqF{x?sQ;X^0BP>FF}KIUK4q-!eY!n0@3NDZeLcTs~|jtI3Ex>B@x<5@tJqMa~DBbC$NmK>N#T3EJB zPJ35i@`3exJRa@yAYlq&eW9vu712RRB4`7$9 z7Ixgpayp94u2d2VR;eWzK7j410b|eR!Gt5|NoZ(A3be3_X@D)eVCCBP#fujf+URgN z91gQ!2wQ_2G-}b?OSsb@T7mpR=(?5{PohhxLl5?h@NT-4dFuN5TD*Kqm5J$uGH0U_ z_^u__aYlvYnEIszwWca1=pH|u4$jOn@7l6M7MGeJqCFVEKFP&t4Mt2-hf_ohZ+VPI z#8^hvEFt5f$PPj!S)KodfS!=4C}KmTFnsy)rMi#_n55YCNr%I+JwWP0zLDK)+|vZD z85Yu0);K{YU`IzS0(urv*WKQ3D~X#oHfqfPVZ|)8Wjl~LC`*-z(nJDG#1Y=Yxg9@+ zxgk&KPI=*bbEL%-rmNFC|S;COAx{noq?UVs4PKe z)jDsk6PRomE~_1*fXAqo z8AfV=X&G^p@VoLQ&}m0~>TCvgc(4G>7P4mm-F*@5L$W5JyNs`|QJ_|$XdhG48Xq3! zz|!UU4e9K3%ZJJ&TcOj&Lk~1v9mF;@+^m)xw;X4Qs^ICKDF{1OL-@3ZFfusGLNb40 zfnTI_iLGXI%j!j7ny}urum$Y4Z2|$r=iJ(q8{*&`(uufn&*5+w0pw>9>Tk<8(QQEH z0TNa9u1gBk8Ppdg;e=72o*JjsPD6c1yb|bY5=z*~n&eOeYX|C_I?|JzV>#Ymp?yp@ zqY|;Dn+N$Gjoa0+mGrK{L1sun8XQx|Ps~K8CbNl|$ehV+eU}O=QYg?PMbSTxPPp`` zrJ8ukxe>ug2h6|*#%=mhnDXEiHZ%JMA6`RvK#HRophDl=+~6Q-&7SO7kJ{|tLjA1{ zHbnKP@LN-2QL&bH`jYV4T0cx6M`N|;00aEhIyoLRbuAh7jF2Rq1wl3B^)73>asbVYK7+ z7-G*t*v#Gx!W8FlG=m(Lw_%&IW7KU^6GoueXaANM1PgWs0?MlR_B7iUpvhw|wog9E z`%qN1*Lacs2z9_1S#TwiJ7UzQ)Y3+Q45( z*#vN6HtFT;!7vSaM0csc8qhUMZNO(@Ry=MY1X734cWdVxdK#D^nWM}QGjzCRUE1Lo z3-6uKyB3ZPU``p!r?A?P3$pH}hAu+zb{9#P0o!qkc4Zq z3Ga*mqXSL&cs%y5h{Lfdi07wSqeKp&UlGV2Vb*6pOq#jXE2Oia-xRkAx0zH$IN!E$ znnsI0`|PtyN}yS_%3%j#N|fCmMs|oWTHNgYU>n$BPA1`=g_;Zsy20;R9nA!<|K6N< z$akyFGFRZv&ovIm(17^b#v#!l=*(|V`HEUCw+=3B6>$vh;7PvP8o+|CB*Rz(#-6= zjD3Cvvx$M)!@@8X%t_>M>;X7X3m>3aofaDbj^{WmTM#k^0inmJI=}^BFNA#TWnC9C z!_p<*;j_;^TdC|xI(r;>EL*L`hL%|l#9*cxEGdA?E-cmLiw7z@A*!Zy`fiB{<4nTeHx zjneYLP~0}&*v{3mZO}muieHVW!0YSloJlCDeAbiILqDVrX4y7Hw<3zK995PrMIo7* zLnU>Z2MU|=xfCP-??4d048fE+R4iuO?tDitaDv^Q;B$;uY=*F_IhUUVm&NP$RX zs=nvXpBJy*1^`KGmKRP9aahW^XA$mDPna@6%UnM)ly)Soq`|W6SDX(T1d1r(j*Bpa zg3$&c521yw_|6G!-bL4U9P8>`zw*dNu6VT~4gG=lIHofDv>d5JllZLA34aJXEhjLr zr5z*`&iVIc?4sJ*RHiRSsPHHr58tlK3JnR9nQ}dU9|^}@r}fdQNvLH7#ac)E3|>vX zZuO!T!Z)C7-5fkF9goM|re9wV?58hYyik)uhhj}95QG(0cQ=6wP?+>`dZ&BLCY?0U ztC$=0{9%gN+^AgTm$M}>x)Up_Sg-1F@Aga7Ss0$B!S=HEWb}N0{eYr{>Yw20u-O zs8A;#C_xeyIPd7y*$J^9sr{x7ryc`_z66)VSn6cr`BzT)6fsywqSWcczNm%jMU5GV zhLCVu@puE!{zhNH-gU7EdP34xY$u-OB82w#j(SUusaZ&t)bb<~m;+LQQMST02$M;f zQal`I0UbleZcx$WI175mc?gLDv}3rl?v_9c%&S+gnrSjnjPcSOkES-@S;LNUV$D{z zTVVS*9*>N0Q9O=mFF_LC2o+rmY;}asE{DSr zBa_%|SAafAW-a4JJj>uMp0z&YEpVn=CN|miu3S)cD%rtMhuhoRLDi>OxWUjdG$0vB zrLMbk=XE(A?4rhR;811?&VA}2pbLphp}`aS_4PIMG-mj%_ZCRDA*2chhz|cl(*&XN zraD{#6|p(yge@?0+F<)vd0=h_qYc7lW>geTpTDsT6o^V>kgY?asi$B0y`8mD|Mm@ zHH4N;ZFrGITKqOp>b552lRkKrrXtfRzR_l{Fa;)6VaL|c;l=i~`J=bw)iUKD8>Va7 zfGM>GFzv}DuFxwmrKNkZYt*QoV_bA`qTtn7y~1&VCP%Jud4lR$cETY6X1$SOh#Beh z8;lggC-E+W7c`?lwvw_ZT!t-Vt_4g~sBi0b4jcLT{&;oE!;WIEc0BKpmhIIEYBqJo*VHf|bCX?fLaE`tCCD$CeU-1B z=6mc=@u(r<&`XlsdE1$c(1#LFWa`u=NvL~QWSfv&&z29uj>ZVRR+_miLVz<&tlqte z+z{a{nNp71pG~KxZJ_0uMRMudVLBZS+^L~C`=W3-T7p@?sK}Yp-V+d~0w?G`3p*A( zXlOa!JKwuUuUSgkC_s1K*;2-k(d(apkZ0;_m;&+Gv0xLP1&<-^5AVFpZ7G!St_^t8 zIUF59GINMEBkF_#^jD9!%c^%M<seC+l1Qot5Tl1WqXHO&x)hc{kmWhW0MMqlo6h6h%1 zD?$S)VRD9vrbxG+#}K0F4H#)1jy<3|J3%RQ@uNfU4PhLh|J7%oeP+Si5IeivLHjo0 zaO?!+f>v`yGFXYuHtN$scSnfLfcL_>o@9hIX2KA=r=ZQ8LFb5DY-UC?9WXBR2FD54 z!ZKm31at8ekZQkJS-@g#7?5lcLKSp!%v;kh@%i$DV{%nUc7qsAokvZeiY=3u(MP{Fz*r; zuWpp(w4y$7hx9MH67uUH^vF4>7}1dK*}F395HjI(v7c-hSpJZuuU@^v9P47cV?qa3 zp#9q?2v@zIxZ8u9`|a)RMcW+auu$&k)I3UB$d+&kkZ4X(S}CAbG?R9$gF_8EqxP=F zkl?geUo1Kt4u^4&Y{cdP{9uVIV+crOtNKDpa@)PprlrGN!V#wNj0(dgO5Nm&KjD&@ zE+^22DM)ldN#O}m$I2UeJ*mAnG1{gB(|#5|mKL+m&;tlw**-XJB| zjreBqwnJ_Yu@)TdVKXF?G90SQP80@55lE2K&?Zf$&APq4b=9#WglnR4&f+!5cNj>6 zC%#ICuMnZ%LifN%3^W^V#7d?BNlM>nlQCHX1mLXSg0xXLXE5uw!EfwvTnaK=HDect zGJ~BIqP2@q<)OaU+ha(&VdI8DNxQ68q%pzJSaiGko+aP(Erx3gyCILXib1bx3X}dx zERZ5s0J9M1Ta<5kIjjc{ZU!wXBSPkeTY(&-gOS}sPv(%4y)jiCvx`EJtJ-^`M2d-h z#^y%DxQt5f{p6x-b3d3v3SAIkgi&`ZSx3-o%YFDA4o5!vMnL5I-joI1L0`OhVNEG@ODGJoiX~mNL-Lm7kT* z4#e5Js^hv%hoa(ONJaZ70EeRnMn6?CcN;dc_N)TJ*;q-DgOWf|GelljXaakX{|*60 zyo<-a9fZ^t&CL7i3uT96Z(t}l*`kJ6GEbg7p(&<|T7US2_7bP45fI1(U5HWl(_Q80Ls+|m15b~qA{#j+VsgW-U4 zw5d437@_aI*-DNA3^zjyOBJZtyFA=h}8WDLb!5PbYX9n^0 zow^*>;(L9_UX|0^V!jCn zY*H3z#ICQev16hprF`=o3dnK5FBcq+3BrgxgPX-HBoe=U48m^nQ^?WyjqP-PX^3;X zI{p+|G!1mRYYQ3~jwk54@y9>@F=jrmK^2c5?$gR(_GTJa#VP1gJFU?5pfiow6X@U0 zzOA7o6tP1xO=NyKj$YWL{>ju)J~I^{4I{5hHaR!WA~aUmx$JXP0?8^fQ|8ssKgq|{ zAg;OIE!gHkW&=n|wV-(K1Uu&!IyCmZs&+VRf_%tW@5cE|Cg@0&{QVP(zn$)#7V^W+ z0^0$UisSLvmn}-RCv|WWy#&W~i0zwYasu=urUbUv_1c2?oI1gWpgl#aC_SAgon6L+h$341<{w&d*sVf6DWxfUh%_h=+>Apmx-2=Ndq;( z=n=1uswkV_(hjhij>jX`@~#|-i-0+fckXr8aUVzji{C;=_C-73txc)qfMp@KTBu%e zTOtbdsM6XH-As4JVemc~N_CGjRi!$cFwG9_sg?Ht-rR9|=o}A1YLY;I1_2G=nI^davP1?WhgL_|t2v(krmZ=7-NWLo@dw9hgtY7aGB-g)`JB z`UcYi;^&~-U#96}+n~>qI-^Q>bElTZ42sE#iy?1D&fPt&+-eKz;nb6~psJ5o7=lc@ z5WSvQ2eo1*x=d^9w+>LcY}XXbgz2`ce;We!evO9_~BQy1Cm~7OJeS09d|3(@GPioTDV=;Ja63no&`}9cs$f7{ zZYcENHRX4g0JFFBu7x=;AX>cug`~nY83mvU@>a!(fNBHX>x4@dKtfA8`u46%Q_%Cr zMWqf@HjXEF2Ra-zAaV3%Ex_wR_R;q5O#@Y8&Yc>P2PKoKsk`ATqzkhkW6|wmFxjom zpGiM;&yu5ZWsI%Z5Y*0ra{sH~*$e#~?06^gM(oEw{&7Lifzafb(^B^_+Xf_d*!^-H zjtR&}-@6t&0;3BJ-c8pw;ENoF_A)4^x5MFZY!XbfrA}m@1H4oW5xY{+<)DgR`qqSe z+IBKu%jp|EW868!CS+>0;mIdSi`vnP?ou_DKixqU_9Z+heOPb?mh$T1g7wugI>;Hg zdB0qT<04>P>@d4cM@Y6`Q?@DQ*=cZRN_x_I}4EW-+`N4unKogTIEKyZ*Ono#mF$jT6J|ePNnn9CDj?aNE9{X5=_Co%OEEx9LBi@C-K_b>LY5 z*xNCaz8^aGqzT9pqgE~GZZ`?U!|(LzO3Xv?)4RL7D>7XnbKLCga5&mSQooI;3KBSA z);_Eaw@ov&!Dh8(zLhm1@rrGrZB)F+n}tGzNu`INSX_cQ$mu-QLuv?JhC5N<70>EG z?|04_w@o=L19KHiOt(5{4X_iIWd~gQuU@^XB)Zj<-DM%$Vh*EqDP-naY7hFbK@n0L zSn|~pydAqLcB}4}#Z0n>7NIg{=XQAelex1?Ig0C7NX{@2?@}>{?~@R7vR z7Dy*ebvTSevPUV{|MmcgdLD!aI?KxitIZ9Cys1v=j?ptCbpk#Uoz|9F`MWGr;W(Ikt#wOH~nLK7W;y07*1*e;*C+N<$B=jZ*auqHD$?{h9PRAf~ zcn$Jrp0)cnlZMuT66MfsCdatF0c0l2>kG9_Kpun$g8XsCU>l%P(d8bN(VfTR(Y|ep z*20#~Y>qbAh7hAi{WjW?hWM1aUsErThr9^yrNeP4HsCo{9FY993#qS+@svcP*w@F* z;(Pb-J}eFf$ZTE-7vGP*!cBMu$sy3@rC2p;*UiJ}mu_>igKl}LRZXJj-WX#xE4~ZR5}scUBY*SDX#lhrgF8xXd%+0dp(7vRt&ko6PaTXX zGi~6x;QJ!H%NXurj-Yo$M?^w=4FJ9BgaPlb?3X6FyN z7K`VowFdgV;Ai({=9q~T5ZBGSySrvDbxcso{Y=V%x_H(?#fV@A^r?^7l{n>i*PwWi z^BF%2E+X-e$r&0kJFgiUhr`hlk}wq7&gdptNEqsDeqrRO4GG@qP6@66lmzj3?--|$ zPmJTpgtcy$X$j~`AQic_b~#2t{tO%xWEmo{iIL@Fq#BJO=kDY2*t;(K1$~ex4RTIK zn8PTC_n2qP$w{s^!Fp${S>WvxQ<9i*E_GN6$>d9|Xw*SEDyJMtF+b@2vZEB}C+Q|i zQ`n66ue}A%aU@&`aZWhN9c%jK#+9Cy# zY==D9x?LW+B2yoZeo^8W6imJep|lxa#Fdbn0z0;;B0yUxRh~b8-n%Zl0CP#Gmk$Sv znGMTUtS{CpT2O~F1J=YN==Szju@MVhK)8>K87G|}Lx|kN_EIq@ZfhkmV}3avd+rb~ z9n9XnZT$|%_E01_0$m*n)=I8ah9EEP5*z4-T*u?bk0q&Gkp(FGd*)rU!;ypH8%l97 za`5Kn#?I{tBdp6_6Oca##df@p7OID4-nq1{Y(D667U344JK~8tq;rX(PdJl=_B~_L z6Qh@wMH`V$tK@AdAD>)0qf65wLcFBz?(Q<%PIl{!DH5?m+J=F#8^sfeev&Kw8y#oC zeINUv8~SR4X)kow5E};jL_Ph)?W!!TE2)e}Srq62NX1cV>zD=Q!-%)N*C&)JjaQjI znH^m~GJN~iQMuDeJ0Xk?84GO3z3PC&GPc)dq|NEA_D{Qb{&^H39>MV=zm>IO(`!aNjtciqz|(WX@7Sxb@e7HN$e))s{8hS)jrQVeZ#)RWj`6IY~k>aP+)_ zcA7JSnDb0qkmHt2JI_V>mHM>86eJ;)Q+LNd1`=+@Hgz}|+}OP>4X0i5*JJHa{ts%U zzZCQo^7zohY3L#PsNoEKFbsjV%({~Hh4=~AxOzjGSh+P6>F^R69b3Hod|>-_m!Y9y zDmkWlQ^+?y(+!?P8M-=1c-^*LDIAUj7zmRS3$WX0Wwe@cg3wj=*#i#V6JZZh+f}gc z=qU<2ue(oxzV_e8(%H7>v@4B1^&wxgjn;bya9AgIp+JdIFbSTA^iVX$2nURrQ zk8lnYv8(J8*n+ti_pZpFfohNm=j@`+j3T6umfwzT4>GbF+Zs#(+Y{C)neKYmMGs6B zY_(Lwy1Px9LXI!)h@jg^z2oF=FOk=SoL80uK$ZagnO9vMeU^+&Fmd0yy}j*Smp%wx zzxLokZ3^UkCUhmx)gMqhz2ujW-wI)Y#!p=xNOyzB?dwHiMzi2DdbmG;)JS_uTTK^3 zO?&#FP>>FHsmD2hMYQ>FQOjUZXZ}Iv(#M6v9BQF@wHndrs-jfp7dsadYk*;(0ZYzGMgJH1+%u_t!UC zwz1IRK{tG13A#Guw<2U++x#RXnat+Xv2~|yr?CZMt&MocThQd=@z}*2$Cy?!|1^HJ zqZA}KE=Q}Bs0RgGZ01U#jVs5&W>NuCc^pFe+Iq+*Ue z18ZD#C*5rq7Rb|k9;Qk$i8am-OIt*<*EzNgrflXhuy|;`bx&kEc&1nT=+|+TY4uilJi32jG#E7oN!$BN?H*DR_kx`h0 zJbYQ6ji{UWf2s?ijkJqr=94E+a$*A+J{G!vNXoXeJ8XPeA7<+-a$ZIuMabSIP;SI~ z?I8dyVplhc4mI-KX1YM= zf7Q1|v`ygv4kdFxijadK`LmI6XJQl_MUB+Q(HM|Lv}tVef&jXfY%#h9X7bU6fipua zF!eHH)#gP; zAa2;6-D3^Hd`x?rDr+FgVyuPglU9gX+I!c<9N0PeZmwk^1|R$0L6o9{hS%{x)VK2C z&6=r6xGOLX?pR^wep}?w0s5On-?Yr=y@ajGK=PQibaWv>)+qLefxt{~=vZAG6CRh8 zCA#?_ep9*yvNtvrnu(yDuJ0}~ykUTJVSNlNqWg#93@8_5IT6GXwWp>%Gze)_X2g~P zz50;$Oh&eDW*i;8Aom*9ay^K%w0mGq5c;_0SQJT>P^wmH7(1H9a>bo8)Fn(L)xD>+Zay%X_Tz_Ep)(fhofvEig!Ri(RU>k#5XyR*sLrUun zcG69<(1e6?gKpC_ld1z}c=KL0@?F@O@?R0UFr9TJdUOv_2-jQesr=J3L3~}*8#=l- z=b8!CkmKHFjQpiS5ibRAaA>RSrC$vyY8J`8OH zT}Wo$UU?9XAe(of=#cl`dr!UT&?^Ry?^auAknVv?rj%)gQGsjrR!&_~uhW-)eJmlp zmucr`>>mF6!3Q7Y)jbQGs~c0UI4&(4723r1;A-e_YzbtMeRE>fu2H^Ner&1)l41bO z-`HNz24!8&91RdEkcw3qX64Y?WEivpZK3#lB>$b;Q1tKg-OW2Q~hnSD^^Fs`uPTX3Mr4@zYT>(zshb^OwI(dRQ%hddp| zmT;-9(&2DefLxZ<*s#P$-7;10p0Cn!AR*P=ubFlT-XQC2J7LVJjyW8%g28CI9Y2#5 zwiKiqmCW)E$1IG@{|R^=gg#&`n}AJIiK8)az{J8i9*<7V*9(vgZ5E?~#zYdW>fXr5 zbW^$6d zc^55IyiI_{uU-QSiAx-6kVch$@>^x^k;_(vUcoqmiCI`Cyh8MmSiT^uC*=dnR2LG` zY?`%!ZveE-dI<9d5VD{c)Egn#G1>NcmUJv3Oa)#<&JQ}fXrSx3Y(=kV)`9J_lWz%3 zkO%axh+_;e4HJcoTGeNca>80NU&}zx(=O3ChB36&v=Qu~7TVq^4(cT-oeiED$xFO* zKh^8&Yl!*=H@1U0yDnv(p8V4p`=onPbJM?NMIuOXlDzIJ*+|! zts;Gnbtm@WoN}lw-`?J~QD65=%*gDMy=&pf1?Dj1w!xtclMy>Jk3+yz;F);_36wxp zd^ks@keYiZdr;V97YGh(pskpcVmY2^bTI;Q{L;e+R<&>oS6og~Mf3)CbDS{^su_pV zsllN9XM!;9bS>YDk-}Iv&Ur@~K%3LUkqM@ayNIScL}sSE%?I8VbTD8ckU8rOp%@XG z#qeq!ktUvv)BG_$F)fzG8EFzLNBV-5&iu3&ot+pttX%COb6)3rmV@K*h@Q_>fgBFY z;QE4)G3e0cI1BrFrU>vMLeeJSu@S3dKTbsLvy(e^1*q1TW9ksC{8WsGhZ&r6{L*o_ z5aFiQ62&uft4S3@7hG$8Dd>E&);!00FemR;SI}9Y`63l{R#x;|j^7kB%F)`dQV@@q;plA1s8#;4D>q>WsgsjnfB$A~saSf?U+f*j)5^Bg>p;8+kv!RXa zjIG5t>vEMLA(CQ|^QV0_fIvv@rV3RQFa8h)+y|(ls783Pl%=6gv#kZur zBFeC!XV0G5oC9{Co`EzV3~F2J4m$Q^a#J^OqeTtH+_dstJjg5Bg{4Zj3bBI?twlQ= zn*@FMd)H!*UTm#;j*zk!b=l_GHL?U&?kvCK)`NTv~CQfhQQCEHS;hP-Btwx-G^>&ZuaJt z0eOP+W8-``m%{9gvvCx0S~G%X*=E~kC$ERhwxGjrPf$-Gseq0#o0qwePIkETi*SHD zb_G(tTPBQZf9bSaru%QEHE% z@z%~}S`Ro#l6>BXtm7e0r#7%H&>1=gQ|B;d%hvP8OolRS5TtwB>NSm{2DYuM?*|aY zHZSsc5B}=at8q10^)~0&JPPvGDjsLx2B2^C8BE0fiD$L`Mx%A>?RT zOnSx3yEYP%Cbh(Uiw}&vtuKHRkpFuHH@73zG!M(UFnBc>v*5T+2a?uZZ9a#j} zNz3wmIaWfvboM#@7y(D}@FK?+s!t^T-Giakkq;R!_lx+!> zXZ-kXqYr4Gp$m|1elkpk9z?~fR~4ZRM0bxyvvZp}xRrOr5@ag5cywf3InIQkhm|g| zuUN6%qV8}wCJ1%8aqsK*sd5wn@3k=pcJ2TJ#T#dtLDg>ssBxjmJ0JJ5fTGpxMC{Ok zJZU-h97qX9(y84r=9*29L^~}d6(7tDJ@eZ%hhtDku04aQ z3$GPky?RyEZ>pZ7JM&63PBXm*OwWz2+_*Z&joWx7YeT%Ls~Q#

JeXh+5)QT?J7p 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 literal 0 HcmV?d00001 From 9abd9809c2a55da50131a5900c0fca2e46b2a150 Mon Sep 17 00:00:00 2001 From: Venus Tools Date: Fri, 19 Apr 2024 14:38:57 +0000 Subject: [PATCH 10/17] chore(release): 2.0.0-dev.1 [skip ci] MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## [2.0.0-dev.1](https://github.com/VenusProtocol/token-bridge/compare/v1.1.0...v2.0.0-dev.1) (2024-04-19) ### ⚠ BREAKING CHANGES * migrate to Solidity 0.8.25 ### Features * migrate to Solidity 0.8.25 ([e679346](https://github.com/VenusProtocol/token-bridge/commit/e67934668330062341da08154722ce5b3d9cec6f)) --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index faf3730..8c2d491 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@venusprotocol/token-bridge", - "version": "1.1.0", + "version": "2.0.0-dev.1", "description": "Contracts to bridge tokens using LayerZero technology and applying some rules on top of it", "files": [ "artifacts", From 2ee72586b7e0741221d4c84ec4543407f0fab748 Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Mon, 22 Apr 2024 11:18:49 +0530 Subject: [PATCH 11/17] chore: add new deployments with new solidity version --- deployments/arbitrumsepolia/XVS.json | 70 ++++---- .../arbitrumsepolia/XVSBridgeAdmin.json | 74 ++++----- .../XVSBridgeAdmin_Implementation.json | 67 ++++---- .../arbitrumsepolia/XVSBridgeAdmin_Proxy.json | 72 ++++----- .../arbitrumsepolia/XVSProxyOFTDest.json | 114 +++++++------ .../15770bc3af16acbd95d8914f14cae6d7.json | 151 ++++++++++++++++++ ... => c5caaaafd4ca2aaf0d7d76349c623fb6.json} | 50 ++---- hardhat.config.ts | 4 + 8 files changed, 382 insertions(+), 220 deletions(-) create mode 100644 deployments/arbitrumsepolia/solcInputs/15770bc3af16acbd95d8914f14cae6d7.json rename deployments/arbitrumsepolia/solcInputs/{f2046c3ab03975d1be43bca1cf657398.json => c5caaaafd4ca2aaf0d7d76349c623fb6.json} (77%) diff --git a/deployments/arbitrumsepolia/XVS.json b/deployments/arbitrumsepolia/XVS.json index a48fc03..f03ffc7 100644 --- a/deployments/arbitrumsepolia/XVS.json +++ b/deployments/arbitrumsepolia/XVS.json @@ -1,5 +1,5 @@ { - "address": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "address": "0x877Dc896e7b13096D3827872e396927BbE704407", "abi": [ { "inputs": [ @@ -716,22 +716,22 @@ "type": "function" } ], - "transactionHash": "0x8f6f0164031904dac588c17a82a178bf480d95a4054ac385fccffda339d93356", + "transactionHash": "0xc7ba0dc4ae1b4577981fbacdacf8700d30bed0180d3055994ef32abe98945425", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "contractAddress": "0x877Dc896e7b13096D3827872e396927BbE704407", "transactionIndex": 1, - "gasUsed": "2883252", - "logsBloom": "0x00000000000000000000000200000000000000000000000400800000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001004000000000000000000000000000000000020000000000000000000800000000000000000000000000000000400000800000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", - "blockHash": "0x588eec9e1599140a788294fd42247c4347f91fa5a24ba98a1e8397af7fe2ac84", - "transactionHash": "0x8f6f0164031904dac588c17a82a178bf480d95a4054ac385fccffda339d93356", + "gasUsed": "1442332", + "logsBloom": "0x00000000008000000000000200000000000000000000000400800000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000010000000000000000000020000000000000000000800000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0xadf70ec3fe01bb630008ec822af3505af4902fea385fc549f4f9c5ae05d9cf8e", + "transactionHash": "0xc7ba0dc4ae1b4577981fbacdacf8700d30bed0180d3055994ef32abe98945425", "logs": [ { "transactionIndex": 1, - "blockNumber": 27132235, - "transactionHash": "0x8f6f0164031904dac588c17a82a178bf480d95a4054ac385fccffda339d93356", - "address": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "blockNumber": 36234761, + "transactionHash": "0xc7ba0dc4ae1b4577981fbacdacf8700d30bed0180d3055994ef32abe98945425", + "address": "0x877Dc896e7b13096D3827872e396927BbE704407", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", @@ -739,22 +739,36 @@ ], "data": "0x", "logIndex": 0, - "blockHash": "0x588eec9e1599140a788294fd42247c4347f91fa5a24ba98a1e8397af7fe2ac84" + "blockHash": "0xadf70ec3fe01bb630008ec822af3505af4902fea385fc549f4f9c5ae05d9cf8e" } ], - "blockNumber": 27132235, - "cumulativeGasUsed": "2883252", + "blockNumber": 36234761, + "cumulativeGasUsed": "1442332", "status": 1, "byzantium": true }, "args": ["0xa36AD96441cB931D8dFEAAaC97D3FaB4B39E590F"], "numDeployments": 1, - "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", - "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user\",\"type\":\"address\"}],\"name\":\"AccountBlacklisted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"AddressesMustDiffer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MintLimitExceed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MintedAmountExceed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NewCapNotGreaterThanMintedTokens\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"user\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"value\",\"type\":\"bool\"}],\"name\":\"BlacklistUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"MintCapChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newLimit\",\"type\":\"uint256\"}],\"name\":\"MintLimitDecreased\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newLimit\",\"type\":\"uint256\"}],\"name\":\"MintLimitIncreased\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"source\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"destination\",\"type\":\"address\"}],\"name\":\"MintedTokensMigrated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"burn\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"decimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"subtractedValue\",\"type\":\"uint256\"}],\"name\":\"decreaseAllowance\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"addedValue\",\"type\":\"uint256\"}],\"name\":\"increaseAllowance\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"}],\"name\":\"isBlackListed\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"source_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"destination_\",\"type\":\"address\"}],\"name\":\"migrateMinterTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"mint\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"minterToCap\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"minterToMintedAmount\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"name\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAccessControlAddress_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"minter_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"setMintCap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"symbol\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"unpause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"value_\",\"type\":\"bool\"}],\"name\":\"updateBlacklist\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"allowance(address,address)\":{\"details\":\"See {IERC20-allowance}.\"},\"approve(address,uint256)\":{\"details\":\"See {IERC20-approve}. NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on `transferFrom`. This is semantically equivalent to an infinite approval. Requirements: - `spender` cannot be the zero address.\"},\"balanceOf(address)\":{\"details\":\"See {IERC20-balanceOf}.\"},\"burn(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits MintLimitIncreased with new available limit.\",\"params\":{\"account_\":\"Address from which tokens be destroyed.\",\"amount_\":\"Amount of tokens to be destroyed.\"}},\"decimals()\":{\"details\":\"Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the default value returned by this function, unless it's overridden. NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}.\"},\"decreaseAllowance(address,uint256)\":{\"details\":\"Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`.\"},\"increaseAllowance(address,uint256)\":{\"details\":\"Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address.\"},\"isBlackListed(address)\":{\"params\":{\"user_\":\"Address of user to check blacklist status.\"},\"returns\":{\"_0\":\"bool status of blacklist.\"}},\"migrateMinterTokens(address,address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"MintLimitExceed is thrown when the minting limit exceeds the cap after migration.AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\",\"custom:event\":\"Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.Emits MintedTokensMigrated.\",\"params\":{\"destination_\":\"Minter address to migrate tokens to.\",\"source_\":\"Minter address to migrate tokens from.\"}},\"mint(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"MintLimitExceed is thrown when minting amount exceeds the maximum cap.\",\"custom:event\":\"Emits MintLimitDecreased with new available limit.\",\"params\":{\"account_\":\"Address to which tokens are assigned.\",\"amount_\":\"Amount of tokens to be assigned.\"}},\"name()\":{\"details\":\"Returns the name of the token.\"},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pause()\":{\"custom:access\":\"Controlled by AccessControlManager.\"},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"renounceOwnership()\":{\"details\":\"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.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only owner.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\",\"custom:event\":\"Emits NewAccessControlManager.\",\"details\":\"Admin function to set the access control address.\",\"params\":{\"newAccessControlAddress_\":\"New address for the access control.\"}},\"setMintCap(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits MintCapChanged.\",\"params\":{\"amount_\":\"Cap for the minter.\",\"minter_\":\"Minter address.\"}},\"symbol()\":{\"details\":\"Returns the symbol of the token, usually a shorter version of the name.\"},\"totalSupply()\":{\"details\":\"See {IERC20-totalSupply}.\"},\"transfer(address,uint256)\":{\"details\":\"See {IERC20-transfer}. Requirements: - `to` cannot be the zero address. - the caller must have a balance of at least `amount`.\"},\"transferFrom(address,address,uint256)\":{\"details\":\"See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated allowance. This is not required by the EIP. See the note at the beginning of {ERC20}. NOTE: Does not update the allowance if the current allowance is the maximum `uint256`. Requirements: - `from` and `to` cannot be the zero address. - `from` must have a balance of at least `amount`. - the caller must have allowance for ``from``'s tokens of at least `amount`.\"},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"unpause()\":{\"custom:access\":\"Controlled by AccessControlManager.\"},\"updateBlacklist(address,bool)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits BlacklistUpdated event.\",\"params\":{\"user_\":\"User address to be affected.\",\"value_\":\"Boolean to toggle value.\"}}},\"title\":\"XVS\",\"version\":1},\"userdoc\":{\"errors\":{\"AccountBlacklisted(address)\":[{\"notice\":\"This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\"}],\"AddressesMustDiffer()\":[{\"notice\":\"This error is used to indicate that the addresses must be different.\"}],\"MintLimitExceed()\":[{\"notice\":\"This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\"}],\"MintedAmountExceed()\":[{\"notice\":\"This error is used to indicate that the minter did not mint the required amount of tokens.\"}],\"NewCapNotGreaterThanMintedTokens()\":[{\"notice\":\"This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\"}],\"Unauthorized()\":[{\"notice\":\"This error is used to indicate that sender is not allowed to perform this action.\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"BlacklistUpdated(address,bool)\":{\"notice\":\"Emitted when the blacklist status of a user is updated.\"},\"MintCapChanged(address,uint256)\":{\"notice\":\"Emitted when the minting cap for a minter is changed.\"},\"MintLimitDecreased(address,uint256)\":{\"notice\":\"Emitted when the minting limit for a minter is decreased.\"},\"MintLimitIncreased(address,uint256)\":{\"notice\":\"Emitted when the minting limit for a minter is increased.\"},\"MintedTokensMigrated(address,address)\":{\"notice\":\"Emitted when all minted tokens are migrated from one minter to another.\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when the address of the access control manager of the contract is updated.\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Access control manager contract address.\"},\"burn(address,uint256)\":{\"notice\":\"Destroys `amount_` tokens from `account_`, reducing the total supply. Checks access and eligibility.\"},\"isBlackListed(address)\":{\"notice\":\"Returns the blacklist status of the address.\"},\"migrateMinterTokens(address,address)\":{\"notice\":\"Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\"},\"mint(address,uint256)\":{\"notice\":\"Creates `amount_` tokens and assigns them to `account_`, increasing the total supply. Checks access and eligibility.\"},\"minterToCap(address)\":{\"notice\":\"A mapping is used to keep track of the maximum amount a minter is permitted to mint.\"},\"minterToMintedAmount(address)\":{\"notice\":\"A Mapping used to keep track of the amount i.e already minted by minter.\"},\"pause()\":{\"notice\":\"Pauses Token\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of the access control manager of this contract.\"},\"setMintCap(address,uint256)\":{\"notice\":\"Sets the minting cap for minter.\"},\"unpause()\":{\"notice\":\"Resumes Token\"},\"updateBlacklist(address,bool)\":{\"notice\":\"Function to update blacklist.\"}},\"notice\":\"XVS contract serves as a customized ERC-20 token with additional minting and burning functionality. It also incorporates access control features provided by the \\\"TokenController\\\" contract to ensure proper governance and restrictions on minting and burning operations.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/token/XVS.sol\":\"XVS\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n _requireNotPaused();\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n _requirePaused();\\n _;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Throws if the contract is paused.\\n */\\n function _requireNotPaused() internal view virtual {\\n require(!paused(), \\\"Pausable: paused\\\");\\n }\\n\\n /**\\n * @dev Throws if the contract is not paused.\\n */\\n function _requirePaused() internal view virtual {\\n require(paused(), \\\"Pausable: not paused\\\");\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0x0849d93b16c9940beb286a7864ed02724b248b93e0d80ef6355af5ef15c64773\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/ERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./IERC20.sol\\\";\\nimport \\\"./extensions/IERC20Metadata.sol\\\";\\nimport \\\"../../utils/Context.sol\\\";\\n\\n/**\\n * @dev Implementation of the {IERC20} interface.\\n *\\n * This implementation is agnostic to the way tokens are created. This means\\n * that a supply mechanism has to be added in a derived contract using {_mint}.\\n * For a generic mechanism see {ERC20PresetMinterPauser}.\\n *\\n * TIP: For a detailed writeup see our guide\\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\\n * to implement supply mechanisms].\\n *\\n * The default value of {decimals} is 18. To change this, you should override\\n * this function so it returns a different value.\\n *\\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\\n * instead returning `false` on failure. This behavior is nonetheless\\n * conventional and does not conflict with the expectations of ERC20\\n * applications.\\n *\\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\\n * This allows applications to reconstruct the allowance for all accounts just\\n * by listening to said events. Other implementations of the EIP may not emit\\n * these events, as it isn't required by the specification.\\n *\\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\\n * functions have been added to mitigate the well-known issues around setting\\n * allowances. See {IERC20-approve}.\\n */\\ncontract ERC20 is Context, IERC20, IERC20Metadata {\\n mapping(address => uint256) private _balances;\\n\\n mapping(address => mapping(address => uint256)) private _allowances;\\n\\n uint256 private _totalSupply;\\n\\n string private _name;\\n string private _symbol;\\n\\n /**\\n * @dev Sets the values for {name} and {symbol}.\\n *\\n * All two of these values are immutable: they can only be set once during\\n * construction.\\n */\\n constructor(string memory name_, string memory symbol_) {\\n _name = name_;\\n _symbol = symbol_;\\n }\\n\\n /**\\n * @dev Returns the name of the token.\\n */\\n function name() public view virtual override returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @dev Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view virtual override returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @dev Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei. This is the default value returned by this function, unless\\n * it's overridden.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view virtual override returns (uint8) {\\n return 18;\\n }\\n\\n /**\\n * @dev See {IERC20-totalSupply}.\\n */\\n function totalSupply() public view virtual override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @dev See {IERC20-balanceOf}.\\n */\\n function balanceOf(address account) public view virtual override returns (uint256) {\\n return _balances[account];\\n }\\n\\n /**\\n * @dev See {IERC20-transfer}.\\n *\\n * Requirements:\\n *\\n * - `to` cannot be the zero address.\\n * - the caller must have a balance of at least `amount`.\\n */\\n function transfer(address to, uint256 amount) public virtual override returns (bool) {\\n address owner = _msgSender();\\n _transfer(owner, to, amount);\\n return true;\\n }\\n\\n /**\\n * @dev See {IERC20-allowance}.\\n */\\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\\n return _allowances[owner][spender];\\n }\\n\\n /**\\n * @dev See {IERC20-approve}.\\n *\\n * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\\n * `transferFrom`. This is semantically equivalent to an infinite approval.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n */\\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\\n address owner = _msgSender();\\n _approve(owner, spender, amount);\\n return true;\\n }\\n\\n /**\\n * @dev See {IERC20-transferFrom}.\\n *\\n * Emits an {Approval} event indicating the updated allowance. This is not\\n * required by the EIP. See the note at the beginning of {ERC20}.\\n *\\n * NOTE: Does not update the allowance if the current allowance\\n * is the maximum `uint256`.\\n *\\n * Requirements:\\n *\\n * - `from` and `to` cannot be the zero address.\\n * - `from` must have a balance of at least `amount`.\\n * - the caller must have allowance for ``from``'s tokens of at least\\n * `amount`.\\n */\\n function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\\n address spender = _msgSender();\\n _spendAllowance(from, spender, amount);\\n _transfer(from, to, amount);\\n return true;\\n }\\n\\n /**\\n * @dev Atomically increases the allowance granted to `spender` by the caller.\\n *\\n * This is an alternative to {approve} that can be used as a mitigation for\\n * problems described in {IERC20-approve}.\\n *\\n * Emits an {Approval} event indicating the updated allowance.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n */\\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\\n address owner = _msgSender();\\n _approve(owner, spender, allowance(owner, spender) + addedValue);\\n return true;\\n }\\n\\n /**\\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\\n *\\n * This is an alternative to {approve} that can be used as a mitigation for\\n * problems described in {IERC20-approve}.\\n *\\n * Emits an {Approval} event indicating the updated allowance.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `spender` must have allowance for the caller of at least\\n * `subtractedValue`.\\n */\\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\\n address owner = _msgSender();\\n uint256 currentAllowance = allowance(owner, spender);\\n require(currentAllowance >= subtractedValue, \\\"ERC20: decreased allowance below zero\\\");\\n unchecked {\\n _approve(owner, spender, currentAllowance - subtractedValue);\\n }\\n\\n return true;\\n }\\n\\n /**\\n * @dev Moves `amount` of tokens from `from` to `to`.\\n *\\n * This internal function is equivalent to {transfer}, and can be used to\\n * e.g. implement automatic token fees, slashing mechanisms, etc.\\n *\\n * Emits a {Transfer} event.\\n *\\n * Requirements:\\n *\\n * - `from` cannot be the zero address.\\n * - `to` cannot be the zero address.\\n * - `from` must have a balance of at least `amount`.\\n */\\n function _transfer(address from, address to, uint256 amount) internal virtual {\\n require(from != address(0), \\\"ERC20: transfer from the zero address\\\");\\n require(to != address(0), \\\"ERC20: transfer to the zero address\\\");\\n\\n _beforeTokenTransfer(from, to, amount);\\n\\n uint256 fromBalance = _balances[from];\\n require(fromBalance >= amount, \\\"ERC20: transfer amount exceeds balance\\\");\\n unchecked {\\n _balances[from] = fromBalance - amount;\\n // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\\n // decrementing then incrementing.\\n _balances[to] += amount;\\n }\\n\\n emit Transfer(from, to, amount);\\n\\n _afterTokenTransfer(from, to, amount);\\n }\\n\\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements:\\n *\\n * - `account` cannot be the zero address.\\n */\\n function _mint(address account, uint256 amount) internal virtual {\\n require(account != address(0), \\\"ERC20: mint to the zero address\\\");\\n\\n _beforeTokenTransfer(address(0), account, amount);\\n\\n _totalSupply += amount;\\n unchecked {\\n // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\\n _balances[account] += amount;\\n }\\n emit Transfer(address(0), account, amount);\\n\\n _afterTokenTransfer(address(0), account, amount);\\n }\\n\\n /**\\n * @dev Destroys `amount` tokens from `account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements:\\n *\\n * - `account` cannot be the zero address.\\n * - `account` must have at least `amount` tokens.\\n */\\n function _burn(address account, uint256 amount) internal virtual {\\n require(account != address(0), \\\"ERC20: burn from the zero address\\\");\\n\\n _beforeTokenTransfer(account, address(0), amount);\\n\\n uint256 accountBalance = _balances[account];\\n require(accountBalance >= amount, \\\"ERC20: burn amount exceeds balance\\\");\\n unchecked {\\n _balances[account] = accountBalance - amount;\\n // Overflow not possible: amount <= accountBalance <= totalSupply.\\n _totalSupply -= amount;\\n }\\n\\n emit Transfer(account, address(0), amount);\\n\\n _afterTokenTransfer(account, address(0), amount);\\n }\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\\n *\\n * This internal function is equivalent to `approve`, and can be used to\\n * e.g. set automatic allowances for certain subsystems, etc.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `owner` cannot be the zero address.\\n * - `spender` cannot be the zero address.\\n */\\n function _approve(address owner, address spender, uint256 amount) internal virtual {\\n require(owner != address(0), \\\"ERC20: approve from the zero address\\\");\\n require(spender != address(0), \\\"ERC20: approve to the zero address\\\");\\n\\n _allowances[owner][spender] = amount;\\n emit Approval(owner, spender, amount);\\n }\\n\\n /**\\n * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\\n *\\n * Does not update the allowance amount in case of infinite allowance.\\n * Revert if not enough allowance is available.\\n *\\n * Might emit an {Approval} event.\\n */\\n function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\\n uint256 currentAllowance = allowance(owner, spender);\\n if (currentAllowance != type(uint256).max) {\\n require(currentAllowance >= amount, \\\"ERC20: insufficient allowance\\\");\\n unchecked {\\n _approve(owner, spender, currentAllowance - amount);\\n }\\n }\\n }\\n\\n /**\\n * @dev Hook that is called before any transfer of tokens. This includes\\n * minting and burning.\\n *\\n * Calling conditions:\\n *\\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\\n * will be transferred to `to`.\\n * - when `from` is zero, `amount` tokens will be minted for `to`.\\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\\n * - `from` and `to` are never both zero.\\n *\\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\\n */\\n function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\\n\\n /**\\n * @dev Hook that is called after any transfer of tokens. This includes\\n * minting and burning.\\n *\\n * Calling conditions:\\n *\\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\\n * has been transferred to `to`.\\n * - when `from` is zero, `amount` tokens have been minted for `to`.\\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\\n * - `from` and `to` are never both zero.\\n *\\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\\n */\\n function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\\n}\\n\",\"keccak256\":\"0xa56ca923f70c1748830700250b19c61b70db9a683516dc5e216694a50445d99c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC20 standard.\\n *\\n * _Available since v4.1._\\n */\\ninterface IERC20Metadata is IERC20 {\\n /**\\n * @dev Returns the name of the token.\\n */\\n function name() external view returns (string memory);\\n\\n /**\\n * @dev Returns the symbol of the token.\\n */\\n function symbol() external view returns (string memory);\\n\\n /**\\n * @dev Returns the decimals places of the token.\\n */\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x8de418a5503946cabe331f35fe242d3201a73f67f77aaeb7110acb1f30423aca\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x8adbe291d659987faf4de606736227ad9d8e1a0e284a33a6ca12b30ab2a504b2\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/token/TokenController.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\nimport { IAccessControlManagerV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\\\";\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { Ownable } from \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\n\\n/**\\n * @title TokenController\\n * @author Venus\\n * @notice TokenController contract acts as a governance and access control mechanism,\\n * allowing the owner to manage minting restrictions and blacklist certain addresses to maintain control and security within the token ecosystem.\\n * It provides a flexible framework for token-related operations.\\n */\\n\\ncontract TokenController is Ownable, Pausable {\\n /**\\n * @notice Access control manager contract address.\\n */\\n address public accessControlManager;\\n /**\\n * @notice A Mapping used to keep track of the blacklist status of addresses.\\n */\\n mapping(address => bool) internal _blacklist;\\n /**\\n * @notice A mapping is used to keep track of the maximum amount a minter is permitted to mint.\\n */\\n mapping(address => uint256) public minterToCap;\\n /**\\n * @notice A Mapping used to keep track of the amount i.e already minted by minter.\\n */\\n mapping(address => uint256) public minterToMintedAmount;\\n\\n /**\\n * @notice Emitted when the blacklist status of a user is updated.\\n */\\n event BlacklistUpdated(address indexed user, bool value);\\n /**\\n * @notice Emitted when the minting limit for a minter is increased.\\n */\\n event MintLimitIncreased(address indexed minter, uint256 newLimit);\\n /**\\n * @notice Emitted when the minting limit for a minter is decreased.\\n */\\n event MintLimitDecreased(address indexed minter, uint256 newLimit);\\n /**\\n * @notice Emitted when the minting cap for a minter is changed.\\n */\\n event MintCapChanged(address indexed minter, uint256 amount);\\n /**\\n * @notice Emitted when the address of the access control manager of the contract is updated.\\n */\\n event NewAccessControlManager(address indexed oldAccessControlManager, address indexed newAccessControlManager);\\n /**\\n * @notice Emitted when all minted tokens are migrated from one minter to another.\\n */\\n event MintedTokensMigrated(address indexed source, address indexed destination);\\n\\n /**\\n * @notice This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\\n */\\n error MintLimitExceed();\\n /**\\n * @notice This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\\n */\\n error AccountBlacklisted(address user);\\n /**\\n * @notice This error is used to indicate that sender is not allowed to perform this action.\\n */\\n error Unauthorized();\\n /**\\n * @notice This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\\n */\\n error NewCapNotGreaterThanMintedTokens();\\n /**\\n * @notice This error is used to indicate that the addresses must be different.\\n */\\n error AddressesMustDiffer();\\n /**\\n * @notice This error is used to indicate that the minter did not mint the required amount of tokens.\\n */\\n error MintedAmountExceed();\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n * @custom:error ZeroAddressNotAllowed is thrown when accessControlManager contract address is zero.\\n */\\n constructor(address accessControlManager_) {\\n ensureNonzeroAddress(accessControlManager_);\\n accessControlManager = accessControlManager_;\\n }\\n\\n /**\\n * @notice Pauses Token\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function pause() external {\\n _ensureAllowed(\\\"pause()\\\");\\n _pause();\\n }\\n\\n /**\\n * @notice Resumes Token\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function unpause() external {\\n _ensureAllowed(\\\"unpause()\\\");\\n _unpause();\\n }\\n\\n /**\\n * @notice Function to update blacklist.\\n * @param user_ User address to be affected.\\n * @param value_ Boolean to toggle value.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits BlacklistUpdated event.\\n */\\n function updateBlacklist(address user_, bool value_) external {\\n _ensureAllowed(\\\"updateBlacklist(address,bool)\\\");\\n _blacklist[user_] = value_;\\n emit BlacklistUpdated(user_, value_);\\n }\\n\\n /**\\n * @notice Sets the minting cap for minter.\\n * @param minter_ Minter address.\\n * @param amount_ Cap for the minter.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintCapChanged.\\n */\\n function setMintCap(address minter_, uint256 amount_) external {\\n _ensureAllowed(\\\"setMintCap(address,uint256)\\\");\\n\\n if (amount_ < minterToMintedAmount[minter_]) {\\n revert NewCapNotGreaterThanMintedTokens();\\n }\\n\\n minterToCap[minter_] = amount_;\\n emit MintCapChanged(minter_, amount_);\\n }\\n\\n /**\\n * @notice Sets the address of the access control manager of this contract.\\n * @dev Admin function to set the access control address.\\n * @param newAccessControlAddress_ New address for the access control.\\n * @custom:access Only owner.\\n * @custom:event Emits NewAccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\\n */\\n function setAccessControlManager(address newAccessControlAddress_) external onlyOwner {\\n ensureNonzeroAddress(newAccessControlAddress_);\\n emit NewAccessControlManager(accessControlManager, newAccessControlAddress_);\\n accessControlManager = newAccessControlAddress_;\\n }\\n\\n /**\\n * @notice Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\\n * @param source_ Minter address to migrate tokens from.\\n * @param destination_ Minter address to migrate tokens to.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error MintLimitExceed is thrown when the minting limit exceeds the cap after migration.\\n * @custom:error AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\\n * @custom:event Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.\\n * @custom:event Emits MintedTokensMigrated.\\n */\\n function migrateMinterTokens(address source_, address destination_) external {\\n _ensureAllowed(\\\"migrateMinterTokens(address,address)\\\");\\n\\n if (source_ == destination_) {\\n revert AddressesMustDiffer();\\n }\\n\\n uint256 sourceCap = minterToCap[source_];\\n uint256 destinationCap = minterToCap[destination_];\\n\\n uint256 sourceMinted = minterToMintedAmount[source_];\\n uint256 destinationMinted = minterToMintedAmount[destination_];\\n uint256 newDestinationMinted = destinationMinted + sourceMinted;\\n\\n if (newDestinationMinted > destinationCap) {\\n revert MintLimitExceed();\\n }\\n\\n minterToMintedAmount[source_] = 0;\\n minterToMintedAmount[destination_] = newDestinationMinted;\\n uint256 availableLimit;\\n unchecked {\\n availableLimit = destinationCap - newDestinationMinted;\\n }\\n\\n emit MintLimitDecreased(destination_, availableLimit);\\n emit MintLimitIncreased(source_, sourceCap);\\n emit MintedTokensMigrated(source_, destination_);\\n }\\n\\n /**\\n * @notice Returns the blacklist status of the address.\\n * @param user_ Address of user to check blacklist status.\\n * @return bool status of blacklist.\\n */\\n function isBlackListed(address user_) external view returns (bool) {\\n return _blacklist[user_];\\n }\\n\\n /**\\n * @dev Checks the minter cap and eligibility of receiver to receive tokens.\\n * @param from_ Minter address.\\n * @param to_ Receiver address.\\n * @param amount_ Amount to be mint.\\n * @custom:error MintLimitExceed is thrown when minting limit exceeds the cap.\\n * @custom:event Emits MintLimitDecreased with minter address and available limits.\\n */\\n function _isEligibleToMint(address from_, address to_, uint256 amount_) internal {\\n uint256 mintingCap = minterToCap[from_];\\n uint256 totalMintedOld = minterToMintedAmount[from_];\\n uint256 totalMintedNew = totalMintedOld + amount_;\\n\\n if (totalMintedNew > mintingCap) {\\n revert MintLimitExceed();\\n }\\n minterToMintedAmount[from_] = totalMintedNew;\\n uint256 availableLimit;\\n unchecked {\\n availableLimit = mintingCap - totalMintedNew;\\n }\\n emit MintLimitDecreased(from_, availableLimit);\\n }\\n\\n /**\\n * @dev This is post hook of burn function, increases minting limit of the minter.\\n * @param from_ Minter address.\\n * @param amount_ Amount burned.\\n * @custom:error MintedAmountExceed is thrown when `amount_` is greater than the tokens minted by `from_`.\\n * @custom:event Emits MintLimitIncreased with minter address and availabe limit.\\n */\\n function _increaseMintLimit(address from_, uint256 amount_) internal {\\n uint256 totalMintedOld = minterToMintedAmount[from_];\\n\\n if (totalMintedOld < amount_) {\\n revert MintedAmountExceed();\\n }\\n\\n uint256 totalMintedNew;\\n unchecked {\\n totalMintedNew = totalMintedOld - amount_;\\n }\\n minterToMintedAmount[from_] = totalMintedNew;\\n uint256 availableLimit = minterToCap[from_] - totalMintedNew;\\n emit MintLimitIncreased(from_, availableLimit);\\n }\\n\\n /**\\n * @dev Checks the caller is allowed to call the specified fuction.\\n * @param functionSig_ Function signatureon which access is to be checked.\\n * @custom:error Unauthorized, thrown when unauthorised user try to access function.\\n */\\n function _ensureAllowed(string memory functionSig_) internal view {\\n if (!IAccessControlManagerV8(accessControlManager).isAllowedToCall(msg.sender, functionSig_)) {\\n revert Unauthorized();\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc17ede791bb2160af4c2741f0d80a7340ab8352cb32581beb1d05a2a6a24ac71\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/token/XVS.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { ERC20 } from \\\"@openzeppelin/contracts/token/ERC20/ERC20.sol\\\";\\n\\nimport { TokenController } from \\\"./TokenController.sol\\\";\\n\\n/**\\n * @title XVS\\n * @author Venus\\n * @notice XVS contract serves as a customized ERC-20 token with additional minting and burning functionality.\\n * It also incorporates access control features provided by the \\\"TokenController\\\" contract to ensure proper governance and restrictions on minting and burning operations.\\n */\\n\\ncontract XVS is ERC20, TokenController {\\n constructor(address accessControlManager_) ERC20(\\\"Venus XVS\\\", \\\"XVS\\\") TokenController(accessControlManager_) {}\\n\\n /**\\n * @notice Creates `amount_` tokens and assigns them to `account_`, increasing\\n * the total supply. Checks access and eligibility.\\n * @param account_ Address to which tokens are assigned.\\n * @param amount_ Amount of tokens to be assigned.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintLimitDecreased with new available limit.\\n * @custom:error MintLimitExceed is thrown when minting amount exceeds the maximum cap.\\n */\\n function mint(address account_, uint256 amount_) external whenNotPaused {\\n _ensureAllowed(\\\"mint(address,uint256)\\\");\\n _isEligibleToMint(msg.sender, account_, amount_);\\n _mint(account_, amount_);\\n }\\n\\n /**\\n * @notice Destroys `amount_` tokens from `account_`, reducing the\\n * total supply. Checks access and eligibility.\\n * @param account_ Address from which tokens be destroyed.\\n * @param amount_ Amount of tokens to be destroyed.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintLimitIncreased with new available limit.\\n */\\n function burn(address account_, uint256 amount_) external whenNotPaused {\\n _ensureAllowed(\\\"burn(address,uint256)\\\");\\n _burn(account_, amount_);\\n _increaseMintLimit(msg.sender, amount_);\\n }\\n\\n /**\\n * @notice Hook that is called before any transfer of tokens. This includes\\n * minting and burning.\\n * @param from_ Address of account from which tokens are to be transferred.\\n * @param to_ Address of the account to which tokens are to be transferred.\\n * @param amount_ The amount of tokens to be transferred.\\n * @custom:error AccountBlacklisted is thrown when either `from` or `to` address is blacklisted.\\n */\\n function _beforeTokenTransfer(address from_, address to_, uint256 amount_) internal override whenNotPaused {\\n if (_blacklist[to_]) {\\n revert AccountBlacklisted(to_);\\n }\\n if (_blacklist[from_]) {\\n revert AccountBlacklisted(from_);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xf26fd5d1197124598105b0b2c6d3e260cb7d3e73ba07ad9dcf81f5c027075962\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", - "bytecode": "0x60806040523480156200001157600080fd5b50604051620019e4380380620019e483398101604081905262000034916200021b565b604080518082018252600981526856656e75732058565360b81b6020808301918252835180850190945260038085526258565360e81b91850191909152825185949262000082929162000175565b5080516200009890600490602084019062000175565b505050620000b5620000af620000f460201b60201c565b620000f8565b6005805460ff60a01b19169055620000cd816200014a565b600680546001600160a01b0319166001600160a01b03929092169190911790555062000289565b3390565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6001600160a01b03811662000172576040516342bcdf7f60e11b815260040160405180910390fd5b50565b82805462000183906200024d565b90600052602060002090601f016020900481019282620001a75760008555620001f2565b82601f10620001c257805160ff1916838001178555620001f2565b82800160010185558215620001f2579182015b82811115620001f2578251825591602001919060010190620001d5565b506200020092915062000204565b5090565b5b8082111562000200576000815560010162000205565b6000602082840312156200022e57600080fd5b81516001600160a01b03811681146200024657600080fd5b9392505050565b600181811c908216806200026257607f821691505b6020821081036200028357634e487b7160e01b600052602260045260246000fd5b50919050565b61174b80620002996000396000f3fe608060405234801561001057600080fd5b50600436106101a95760003560e01c80637b517334116100f9578063a9059cbb11610097578063d89e2dac11610071578063d89e2dac14610390578063dd62ed3e146103a3578063e47d6060146103b6578063f2fde38b146103e257600080fd5b8063a9059cbb14610357578063b4a0bdf31461036a578063c06abe771461037d57600080fd5b80639155e083116100d35780639155e0831461031657806395d89b41146103295780639dc29fac14610331578063a457c2d71461034457600080fd5b80637b517334146102c95780638456cb59146102e95780638da5cb5b146102f157600080fd5b8063391efe121161016657806340c10f191161014057806340c10f19146102735780635c975abb1461028657806370a0823114610298578063715018a6146102c157600080fd5b8063391efe121461023857806339509351146102585780633f4ba83a1461026b57600080fd5b806306fdde03146101ae578063095ea7b3146101cc5780630e32cb86146101ef57806318160ddd1461020457806323b872dd14610216578063313ce56714610229575b600080fd5b6101b66103f5565b6040516101c391906114fa565b60405180910390f35b6101df6101da366004611530565b610487565b60405190151581526020016101c3565b6102026101fd36600461155a565b61049f565b005b6002545b6040519081526020016101c3565b6101df610224366004611575565b61050c565b604051601281526020016101c3565b61020861024636600461155a565b60086020526000908152604090205481565b6101df610266366004611530565b610530565b610202610552565b610202610281366004611530565b610586565b600554600160a01b900460ff166101df565b6102086102a636600461155a565b6001600160a01b031660009081526020819052604090205490565b6102026105dd565b6102086102d736600461155a565b60096020526000908152604090205481565b6102026105ef565b6005546001600160a01b03165b6040516001600160a01b0390911681526020016101c3565b6102026103243660046115bf565b61061f565b6101b66106bd565b61020261033f366004611530565b6106cc565b6101df610352366004611530565b61071e565b6101df610365366004611530565b61079e565b6006546102fe906001600160a01b031681565b61020261038b366004611530565b6107ac565b61020261039e3660046115f6565b610870565b6102086103b13660046115f6565b610a18565b6101df6103c436600461155a565b6001600160a01b031660009081526007602052604090205460ff1690565b6102026103f036600461155a565b610a43565b60606003805461040490611629565b80601f016020809104026020016040519081016040528092919081815260200182805461043090611629565b801561047d5780601f106104525761010080835404028352916020019161047d565b820191906000526020600020905b81548152906001019060200180831161046057829003601f168201915b5050505050905090565b600033610495818585610abc565b5060019392505050565b6104a7610be1565b6104b081610c3b565b6006546040516001600160a01b038084169216907f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa090600090a3600680546001600160a01b0319166001600160a01b0392909216919091179055565b60003361051a858285610c62565b610525858585610cdc565b506001949350505050565b6000336104958185856105438383610a18565b61054d9190611679565b610abc565b61057c60405180604001604052806009815260200168756e7061757365282960b81b815250610e8b565b610584610f1a565b565b61058e610f6f565b6105c4604051806040016040528060158152602001746d696e7428616464726573732c75696e743235362960581b815250610e8b565b6105cf338383610fbc565b6105d98282611072565b5050565b6105e5610be1565b610584600061113d565b610617604051806040016040528060078152602001667061757365282960c81b815250610e8b565b61058461118f565b61065d6040518060400160405280601d81526020017f757064617465426c61636b6c69737428616464726573732c626f6f6c29000000815250610e8b565b6001600160a01b038216600081815260076020908152604091829020805460ff191685151590811790915591519182527f6a12b3df6cba4203bd7fd06b816789f87de8c594299aed5717ae070fac781bac91015b60405180910390a25050565b60606004805461040490611629565b6106d4610f6f565b61070a604051806040016040528060158152602001746275726e28616464726573732c75696e743235362960581b815250610e8b565b61071482826111d2565b6105d9338261130d565b6000338161072c8286610a18565b9050838110156107915760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6105258286868403610abc565b600033610495818585610cdc565b6107ea6040518060400160405280601b81526020017f7365744d696e7443617028616464726573732c75696e74323536290000000000815250610e8b565b6001600160a01b0382166000908152600960205260409020548110156108235760405163ce89973d60e01b815260040160405180910390fd5b6001600160a01b03821660008181526008602052604090819020839055517f01a85f4ecff52e70907e25b863010bca98a9458d9f2fe9b3efb4c47d197e6448906106b19084815260200190565b6108916040518060600160405280602481526020016116f260249139610e8b565b806001600160a01b0316826001600160a01b0316036108c3576040516380ae98f560e01b815260040160405180910390fd5b6001600160a01b038083166000818152600860209081526040808320549486168084528184205494845260099092528083205491835282205490916109088383611679565b90508381111561092b57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038781166000908152600960209081526040808320839055928916808352918390208490559151838703808252927fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61910160405180910390a2876001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb876040516109c691815260200190565b60405180910390a2866001600160a01b0316886001600160a01b03167f63ce671e4a37975f0a9e340f6f72320c617a5f728b83e3860b03aa847dc26ebb60405160405180910390a35050505050505050565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b610a4b610be1565b6001600160a01b038116610ab05760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610788565b610ab98161113d565b50565b6001600160a01b038316610b1e5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610788565b6001600160a01b038216610b7f5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610788565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6005546001600160a01b031633146105845760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610788565b6001600160a01b038116610ab9576040516342bcdf7f60e11b815260040160405180910390fd5b6000610c6e8484610a18565b90506000198114610cd65781811015610cc95760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610788565b610cd68484848403610abc565b50505050565b6001600160a01b038316610d405760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610788565b6001600160a01b038216610da25760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610788565b610dad8383836113cb565b6001600160a01b03831660009081526020819052604090205481811015610e255760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610788565b6001600160a01b03848116600081815260208181526040808320878703905593871680835291849020805487019055925185815290927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3610cd6565b6006546040516318c5e8ab60e01b81526001600160a01b03909116906318c5e8ab90610ebd9033908590600401611691565b602060405180830381865afa158015610eda573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610efe91906116bd565b610ab9576040516282b42960e81b815260040160405180910390fd5b610f2261145d565b6005805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600554600160a01b900460ff16156105845760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610788565b6001600160a01b03831660009081526008602090815260408083205460099092528220549091610fec8483611679565b90508281111561100f57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038616600081815260096020526040908190208390555182850391907fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61906110619084815260200190565b60405180910390a250505050505050565b6001600160a01b0382166110c85760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610788565b6110d4600083836113cb565b80600260008282546110e69190611679565b90915550506001600160a01b038216600081815260208181526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b611197610f6f565b6005805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f523390565b6001600160a01b0382166112325760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610788565b61123e826000836113cb565b6001600160a01b038216600090815260208190526040902054818110156112b25760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610788565b6001600160a01b0383166000818152602081815260408083208686039055600280548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9101610bd4565b505050565b6001600160a01b03821660009081526009602052604090205481811015611347576040516348af2f2960e11b815260040160405180910390fd5b6001600160a01b038316600090815260096020908152604080832085850390819055600890925282205490919061137f9083906116da565b9050846001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb826040516113bc91815260200190565b60405180910390a25050505050565b6113d3610f6f565b6001600160a01b03821660009081526007602052604090205460ff16156114185760405163571f7b4960e01b81526001600160a01b0383166004820152602401610788565b6001600160a01b03831660009081526007602052604090205460ff16156113085760405163571f7b4960e01b81526001600160a01b0384166004820152602401610788565b600554600160a01b900460ff166105845760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610788565b6000815180845260005b818110156114d3576020818501810151868301820152016114b7565b818111156114e5576000602083870101525b50601f01601f19169290920160200192915050565b60208152600061150d60208301846114ad565b9392505050565b80356001600160a01b038116811461152b57600080fd5b919050565b6000806040838503121561154357600080fd5b61154c83611514565b946020939093013593505050565b60006020828403121561156c57600080fd5b61150d82611514565b60008060006060848603121561158a57600080fd5b61159384611514565b92506115a160208501611514565b9150604084013590509250925092565b8015158114610ab957600080fd5b600080604083850312156115d257600080fd5b6115db83611514565b915060208301356115eb816115b1565b809150509250929050565b6000806040838503121561160957600080fd5b61161283611514565b915061162060208401611514565b90509250929050565b600181811c9082168061163d57607f821691505b60208210810361165d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b6000821982111561168c5761168c611663565b500190565b6001600160a01b03831681526040602082018190526000906116b5908301846114ad565b949350505050565b6000602082840312156116cf57600080fd5b815161150d816115b1565b6000828210156116ec576116ec611663565b50039056fe6d6967726174654d696e746572546f6b656e7328616464726573732c6164647265737329a26469706673582212202dd502ad7f111f919097342862e006098fd7d7236fbb113e5b8a2648ff94916664736f6c634300080d0033", - "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106101a95760003560e01c80637b517334116100f9578063a9059cbb11610097578063d89e2dac11610071578063d89e2dac14610390578063dd62ed3e146103a3578063e47d6060146103b6578063f2fde38b146103e257600080fd5b8063a9059cbb14610357578063b4a0bdf31461036a578063c06abe771461037d57600080fd5b80639155e083116100d35780639155e0831461031657806395d89b41146103295780639dc29fac14610331578063a457c2d71461034457600080fd5b80637b517334146102c95780638456cb59146102e95780638da5cb5b146102f157600080fd5b8063391efe121161016657806340c10f191161014057806340c10f19146102735780635c975abb1461028657806370a0823114610298578063715018a6146102c157600080fd5b8063391efe121461023857806339509351146102585780633f4ba83a1461026b57600080fd5b806306fdde03146101ae578063095ea7b3146101cc5780630e32cb86146101ef57806318160ddd1461020457806323b872dd14610216578063313ce56714610229575b600080fd5b6101b66103f5565b6040516101c391906114fa565b60405180910390f35b6101df6101da366004611530565b610487565b60405190151581526020016101c3565b6102026101fd36600461155a565b61049f565b005b6002545b6040519081526020016101c3565b6101df610224366004611575565b61050c565b604051601281526020016101c3565b61020861024636600461155a565b60086020526000908152604090205481565b6101df610266366004611530565b610530565b610202610552565b610202610281366004611530565b610586565b600554600160a01b900460ff166101df565b6102086102a636600461155a565b6001600160a01b031660009081526020819052604090205490565b6102026105dd565b6102086102d736600461155a565b60096020526000908152604090205481565b6102026105ef565b6005546001600160a01b03165b6040516001600160a01b0390911681526020016101c3565b6102026103243660046115bf565b61061f565b6101b66106bd565b61020261033f366004611530565b6106cc565b6101df610352366004611530565b61071e565b6101df610365366004611530565b61079e565b6006546102fe906001600160a01b031681565b61020261038b366004611530565b6107ac565b61020261039e3660046115f6565b610870565b6102086103b13660046115f6565b610a18565b6101df6103c436600461155a565b6001600160a01b031660009081526007602052604090205460ff1690565b6102026103f036600461155a565b610a43565b60606003805461040490611629565b80601f016020809104026020016040519081016040528092919081815260200182805461043090611629565b801561047d5780601f106104525761010080835404028352916020019161047d565b820191906000526020600020905b81548152906001019060200180831161046057829003601f168201915b5050505050905090565b600033610495818585610abc565b5060019392505050565b6104a7610be1565b6104b081610c3b565b6006546040516001600160a01b038084169216907f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa090600090a3600680546001600160a01b0319166001600160a01b0392909216919091179055565b60003361051a858285610c62565b610525858585610cdc565b506001949350505050565b6000336104958185856105438383610a18565b61054d9190611679565b610abc565b61057c60405180604001604052806009815260200168756e7061757365282960b81b815250610e8b565b610584610f1a565b565b61058e610f6f565b6105c4604051806040016040528060158152602001746d696e7428616464726573732c75696e743235362960581b815250610e8b565b6105cf338383610fbc565b6105d98282611072565b5050565b6105e5610be1565b610584600061113d565b610617604051806040016040528060078152602001667061757365282960c81b815250610e8b565b61058461118f565b61065d6040518060400160405280601d81526020017f757064617465426c61636b6c69737428616464726573732c626f6f6c29000000815250610e8b565b6001600160a01b038216600081815260076020908152604091829020805460ff191685151590811790915591519182527f6a12b3df6cba4203bd7fd06b816789f87de8c594299aed5717ae070fac781bac91015b60405180910390a25050565b60606004805461040490611629565b6106d4610f6f565b61070a604051806040016040528060158152602001746275726e28616464726573732c75696e743235362960581b815250610e8b565b61071482826111d2565b6105d9338261130d565b6000338161072c8286610a18565b9050838110156107915760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6105258286868403610abc565b600033610495818585610cdc565b6107ea6040518060400160405280601b81526020017f7365744d696e7443617028616464726573732c75696e74323536290000000000815250610e8b565b6001600160a01b0382166000908152600960205260409020548110156108235760405163ce89973d60e01b815260040160405180910390fd5b6001600160a01b03821660008181526008602052604090819020839055517f01a85f4ecff52e70907e25b863010bca98a9458d9f2fe9b3efb4c47d197e6448906106b19084815260200190565b6108916040518060600160405280602481526020016116f260249139610e8b565b806001600160a01b0316826001600160a01b0316036108c3576040516380ae98f560e01b815260040160405180910390fd5b6001600160a01b038083166000818152600860209081526040808320549486168084528184205494845260099092528083205491835282205490916109088383611679565b90508381111561092b57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038781166000908152600960209081526040808320839055928916808352918390208490559151838703808252927fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61910160405180910390a2876001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb876040516109c691815260200190565b60405180910390a2866001600160a01b0316886001600160a01b03167f63ce671e4a37975f0a9e340f6f72320c617a5f728b83e3860b03aa847dc26ebb60405160405180910390a35050505050505050565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b610a4b610be1565b6001600160a01b038116610ab05760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610788565b610ab98161113d565b50565b6001600160a01b038316610b1e5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610788565b6001600160a01b038216610b7f5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610788565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6005546001600160a01b031633146105845760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610788565b6001600160a01b038116610ab9576040516342bcdf7f60e11b815260040160405180910390fd5b6000610c6e8484610a18565b90506000198114610cd65781811015610cc95760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610788565b610cd68484848403610abc565b50505050565b6001600160a01b038316610d405760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610788565b6001600160a01b038216610da25760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610788565b610dad8383836113cb565b6001600160a01b03831660009081526020819052604090205481811015610e255760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610788565b6001600160a01b03848116600081815260208181526040808320878703905593871680835291849020805487019055925185815290927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3610cd6565b6006546040516318c5e8ab60e01b81526001600160a01b03909116906318c5e8ab90610ebd9033908590600401611691565b602060405180830381865afa158015610eda573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610efe91906116bd565b610ab9576040516282b42960e81b815260040160405180910390fd5b610f2261145d565b6005805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600554600160a01b900460ff16156105845760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610788565b6001600160a01b03831660009081526008602090815260408083205460099092528220549091610fec8483611679565b90508281111561100f57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038616600081815260096020526040908190208390555182850391907fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61906110619084815260200190565b60405180910390a250505050505050565b6001600160a01b0382166110c85760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610788565b6110d4600083836113cb565b80600260008282546110e69190611679565b90915550506001600160a01b038216600081815260208181526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b611197610f6f565b6005805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f523390565b6001600160a01b0382166112325760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610788565b61123e826000836113cb565b6001600160a01b038216600090815260208190526040902054818110156112b25760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610788565b6001600160a01b0383166000818152602081815260408083208686039055600280548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9101610bd4565b505050565b6001600160a01b03821660009081526009602052604090205481811015611347576040516348af2f2960e11b815260040160405180910390fd5b6001600160a01b038316600090815260096020908152604080832085850390819055600890925282205490919061137f9083906116da565b9050846001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb826040516113bc91815260200190565b60405180910390a25050505050565b6113d3610f6f565b6001600160a01b03821660009081526007602052604090205460ff16156114185760405163571f7b4960e01b81526001600160a01b0383166004820152602401610788565b6001600160a01b03831660009081526007602052604090205460ff16156113085760405163571f7b4960e01b81526001600160a01b0384166004820152602401610788565b600554600160a01b900460ff166105845760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610788565b6000815180845260005b818110156114d3576020818501810151868301820152016114b7565b818111156114e5576000602083870101525b50601f01601f19169290920160200192915050565b60208152600061150d60208301846114ad565b9392505050565b80356001600160a01b038116811461152b57600080fd5b919050565b6000806040838503121561154357600080fd5b61154c83611514565b946020939093013593505050565b60006020828403121561156c57600080fd5b61150d82611514565b60008060006060848603121561158a57600080fd5b61159384611514565b92506115a160208501611514565b9150604084013590509250925092565b8015158114610ab957600080fd5b600080604083850312156115d257600080fd5b6115db83611514565b915060208301356115eb816115b1565b809150509250929050565b6000806040838503121561160957600080fd5b61161283611514565b915061162060208401611514565b90509250929050565b600181811c9082168061163d57607f821691505b60208210810361165d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b6000821982111561168c5761168c611663565b500190565b6001600160a01b03831681526040602082018190526000906116b5908301846114ad565b949350505050565b6000602082840312156116cf57600080fd5b815161150d816115b1565b6000828210156116ec576116ec611663565b50039056fe6d6967726174654d696e746572546f6b656e7328616464726573732c6164647265737329a26469706673582212202dd502ad7f111f919097342862e006098fd7d7236fbb113e5b8a2648ff94916664736f6c634300080d0033", + "solcInputHash": "c5caaaafd4ca2aaf0d7d76349c623fb6", + "metadata": "{\"compiler\":{\"version\":\"0.8.25+commit.b61c2a91\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user\",\"type\":\"address\"}],\"name\":\"AccountBlacklisted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"AddressesMustDiffer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MintLimitExceed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MintedAmountExceed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NewCapNotGreaterThanMintedTokens\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"user\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"value\",\"type\":\"bool\"}],\"name\":\"BlacklistUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"MintCapChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newLimit\",\"type\":\"uint256\"}],\"name\":\"MintLimitDecreased\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"minter\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newLimit\",\"type\":\"uint256\"}],\"name\":\"MintLimitIncreased\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"source\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"destination\",\"type\":\"address\"}],\"name\":\"MintedTokensMigrated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"owner\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"burn\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"decimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"subtractedValue\",\"type\":\"uint256\"}],\"name\":\"decreaseAllowance\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"spender\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"addedValue\",\"type\":\"uint256\"}],\"name\":\"increaseAllowance\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"}],\"name\":\"isBlackListed\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"source_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"destination_\",\"type\":\"address\"}],\"name\":\"migrateMinterTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"account_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"mint\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"minterToCap\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"minterToMintedAmount\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"name\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAccessControlAddress_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"minter_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"setMintCap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"symbol\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"unpause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"value_\",\"type\":\"bool\"}],\"name\":\"updateBlacklist\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"events\":{\"Approval(address,address,uint256)\":{\"details\":\"Emitted when the allowance of a `spender` for an `owner` is set by a call to {approve}. `value` is the new allowance.\"},\"Paused(address)\":{\"details\":\"Emitted when the pause is triggered by `account`.\"},\"Transfer(address,address,uint256)\":{\"details\":\"Emitted when `value` tokens are moved from one account (`from`) to another (`to`). Note that `value` may be zero.\"},\"Unpaused(address)\":{\"details\":\"Emitted when the pause is lifted by `account`.\"}},\"kind\":\"dev\",\"methods\":{\"allowance(address,address)\":{\"details\":\"See {IERC20-allowance}.\"},\"approve(address,uint256)\":{\"details\":\"See {IERC20-approve}. NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on `transferFrom`. This is semantically equivalent to an infinite approval. Requirements: - `spender` cannot be the zero address.\"},\"balanceOf(address)\":{\"details\":\"See {IERC20-balanceOf}.\"},\"burn(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits MintLimitIncreased with new available limit.\",\"params\":{\"account_\":\"Address from which tokens be destroyed.\",\"amount_\":\"Amount of tokens to be destroyed.\"}},\"decimals()\":{\"details\":\"Returns the number of decimals used to get its user representation. For example, if `decimals` equals `2`, a balance of `505` tokens should be displayed to a user as `5.05` (`505 / 10 ** 2`). Tokens usually opt for a value of 18, imitating the relationship between Ether and Wei. This is the default value returned by this function, unless it's overridden. NOTE: This information is only used for _display_ purposes: it in no way affects any of the arithmetic of the contract, including {IERC20-balanceOf} and {IERC20-transfer}.\"},\"decreaseAllowance(address,uint256)\":{\"details\":\"Atomically decreases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address. - `spender` must have allowance for the caller of at least `subtractedValue`.\"},\"increaseAllowance(address,uint256)\":{\"details\":\"Atomically increases the allowance granted to `spender` by the caller. This is an alternative to {approve} that can be used as a mitigation for problems described in {IERC20-approve}. Emits an {Approval} event indicating the updated allowance. Requirements: - `spender` cannot be the zero address.\"},\"isBlackListed(address)\":{\"params\":{\"user_\":\"Address of user to check blacklist status.\"},\"returns\":{\"_0\":\"bool status of blacklist.\"}},\"migrateMinterTokens(address,address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"MintLimitExceed is thrown when the minting limit exceeds the cap after migration.AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\",\"custom:event\":\"Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.Emits MintedTokensMigrated.\",\"params\":{\"destination_\":\"Minter address to migrate tokens to.\",\"source_\":\"Minter address to migrate tokens from.\"}},\"mint(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"MintLimitExceed is thrown when minting amount exceeds the maximum cap.\",\"custom:event\":\"Emits MintLimitDecreased with new available limit.\",\"params\":{\"account_\":\"Address to which tokens are assigned.\",\"amount_\":\"Amount of tokens to be assigned.\"}},\"name()\":{\"details\":\"Returns the name of the token.\"},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pause()\":{\"custom:access\":\"Controlled by AccessControlManager.\"},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"renounceOwnership()\":{\"details\":\"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.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only owner.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\",\"custom:event\":\"Emits NewAccessControlManager.\",\"details\":\"Admin function to set the access control address.\",\"params\":{\"newAccessControlAddress_\":\"New address for the access control.\"}},\"setMintCap(address,uint256)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits MintCapChanged.\",\"params\":{\"amount_\":\"Cap for the minter.\",\"minter_\":\"Minter address.\"}},\"symbol()\":{\"details\":\"Returns the symbol of the token, usually a shorter version of the name.\"},\"totalSupply()\":{\"details\":\"See {IERC20-totalSupply}.\"},\"transfer(address,uint256)\":{\"details\":\"See {IERC20-transfer}. Requirements: - `to` cannot be the zero address. - the caller must have a balance of at least `amount`.\"},\"transferFrom(address,address,uint256)\":{\"details\":\"See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated allowance. This is not required by the EIP. See the note at the beginning of {ERC20}. NOTE: Does not update the allowance if the current allowance is the maximum `uint256`. Requirements: - `from` and `to` cannot be the zero address. - `from` must have a balance of at least `amount`. - the caller must have allowance for ``from``'s tokens of at least `amount`.\"},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"unpause()\":{\"custom:access\":\"Controlled by AccessControlManager.\"},\"updateBlacklist(address,bool)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:event\":\"Emits BlacklistUpdated event.\",\"params\":{\"user_\":\"User address to be affected.\",\"value_\":\"Boolean to toggle value.\"}}},\"title\":\"XVS\",\"version\":1},\"userdoc\":{\"errors\":{\"AccountBlacklisted(address)\":[{\"notice\":\"This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\"}],\"AddressesMustDiffer()\":[{\"notice\":\"This error is used to indicate that the addresses must be different.\"}],\"MintLimitExceed()\":[{\"notice\":\"This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\"}],\"MintedAmountExceed()\":[{\"notice\":\"This error is used to indicate that the minter did not mint the required amount of tokens.\"}],\"NewCapNotGreaterThanMintedTokens()\":[{\"notice\":\"This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\"}],\"Unauthorized()\":[{\"notice\":\"This error is used to indicate that sender is not allowed to perform this action.\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"BlacklistUpdated(address,bool)\":{\"notice\":\"Emitted when the blacklist status of a user is updated.\"},\"MintCapChanged(address,uint256)\":{\"notice\":\"Emitted when the minting cap for a minter is changed.\"},\"MintLimitDecreased(address,uint256)\":{\"notice\":\"Emitted when the minting limit for a minter is decreased.\"},\"MintLimitIncreased(address,uint256)\":{\"notice\":\"Emitted when the minting limit for a minter is increased.\"},\"MintedTokensMigrated(address,address)\":{\"notice\":\"Emitted when all minted tokens are migrated from one minter to another.\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when the address of the access control manager of the contract is updated.\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Access control manager contract address.\"},\"burn(address,uint256)\":{\"notice\":\"Destroys `amount_` tokens from `account_`, reducing the total supply. Checks access and eligibility.\"},\"isBlackListed(address)\":{\"notice\":\"Returns the blacklist status of the address.\"},\"migrateMinterTokens(address,address)\":{\"notice\":\"Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\"},\"mint(address,uint256)\":{\"notice\":\"Creates `amount_` tokens and assigns them to `account_`, increasing the total supply. Checks access and eligibility.\"},\"minterToCap(address)\":{\"notice\":\"A mapping is used to keep track of the maximum amount a minter is permitted to mint.\"},\"minterToMintedAmount(address)\":{\"notice\":\"A Mapping used to keep track of the amount i.e already minted by minter.\"},\"pause()\":{\"notice\":\"Pauses Token\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of the access control manager of this contract.\"},\"setMintCap(address,uint256)\":{\"notice\":\"Sets the minting cap for minter.\"},\"unpause()\":{\"notice\":\"Resumes Token\"},\"updateBlacklist(address,bool)\":{\"notice\":\"Function to update blacklist.\"}},\"notice\":\"XVS contract serves as a customized ERC-20 token with additional minting and burning functionality. It also incorporates access control features provided by the \\\"TokenController\\\" contract to ensure proper governance and restrictions on minting and burning operations.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/token/XVS.sol\":\"XVS\"},\"evmVersion\":\"paris\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n _requireNotPaused();\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n _requirePaused();\\n _;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Throws if the contract is paused.\\n */\\n function _requireNotPaused() internal view virtual {\\n require(!paused(), \\\"Pausable: paused\\\");\\n }\\n\\n /**\\n * @dev Throws if the contract is not paused.\\n */\\n function _requirePaused() internal view virtual {\\n require(paused(), \\\"Pausable: not paused\\\");\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0x0849d93b16c9940beb286a7864ed02724b248b93e0d80ef6355af5ef15c64773\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/ERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./IERC20.sol\\\";\\nimport \\\"./extensions/IERC20Metadata.sol\\\";\\nimport \\\"../../utils/Context.sol\\\";\\n\\n/**\\n * @dev Implementation of the {IERC20} interface.\\n *\\n * This implementation is agnostic to the way tokens are created. This means\\n * that a supply mechanism has to be added in a derived contract using {_mint}.\\n * For a generic mechanism see {ERC20PresetMinterPauser}.\\n *\\n * TIP: For a detailed writeup see our guide\\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\\n * to implement supply mechanisms].\\n *\\n * The default value of {decimals} is 18. To change this, you should override\\n * this function so it returns a different value.\\n *\\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\\n * instead returning `false` on failure. This behavior is nonetheless\\n * conventional and does not conflict with the expectations of ERC20\\n * applications.\\n *\\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\\n * This allows applications to reconstruct the allowance for all accounts just\\n * by listening to said events. Other implementations of the EIP may not emit\\n * these events, as it isn't required by the specification.\\n *\\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\\n * functions have been added to mitigate the well-known issues around setting\\n * allowances. See {IERC20-approve}.\\n */\\ncontract ERC20 is Context, IERC20, IERC20Metadata {\\n mapping(address => uint256) private _balances;\\n\\n mapping(address => mapping(address => uint256)) private _allowances;\\n\\n uint256 private _totalSupply;\\n\\n string private _name;\\n string private _symbol;\\n\\n /**\\n * @dev Sets the values for {name} and {symbol}.\\n *\\n * All two of these values are immutable: they can only be set once during\\n * construction.\\n */\\n constructor(string memory name_, string memory symbol_) {\\n _name = name_;\\n _symbol = symbol_;\\n }\\n\\n /**\\n * @dev Returns the name of the token.\\n */\\n function name() public view virtual override returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @dev Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view virtual override returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @dev Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei. This is the default value returned by this function, unless\\n * it's overridden.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view virtual override returns (uint8) {\\n return 18;\\n }\\n\\n /**\\n * @dev See {IERC20-totalSupply}.\\n */\\n function totalSupply() public view virtual override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @dev See {IERC20-balanceOf}.\\n */\\n function balanceOf(address account) public view virtual override returns (uint256) {\\n return _balances[account];\\n }\\n\\n /**\\n * @dev See {IERC20-transfer}.\\n *\\n * Requirements:\\n *\\n * - `to` cannot be the zero address.\\n * - the caller must have a balance of at least `amount`.\\n */\\n function transfer(address to, uint256 amount) public virtual override returns (bool) {\\n address owner = _msgSender();\\n _transfer(owner, to, amount);\\n return true;\\n }\\n\\n /**\\n * @dev See {IERC20-allowance}.\\n */\\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\\n return _allowances[owner][spender];\\n }\\n\\n /**\\n * @dev See {IERC20-approve}.\\n *\\n * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\\n * `transferFrom`. This is semantically equivalent to an infinite approval.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n */\\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\\n address owner = _msgSender();\\n _approve(owner, spender, amount);\\n return true;\\n }\\n\\n /**\\n * @dev See {IERC20-transferFrom}.\\n *\\n * Emits an {Approval} event indicating the updated allowance. This is not\\n * required by the EIP. See the note at the beginning of {ERC20}.\\n *\\n * NOTE: Does not update the allowance if the current allowance\\n * is the maximum `uint256`.\\n *\\n * Requirements:\\n *\\n * - `from` and `to` cannot be the zero address.\\n * - `from` must have a balance of at least `amount`.\\n * - the caller must have allowance for ``from``'s tokens of at least\\n * `amount`.\\n */\\n function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\\n address spender = _msgSender();\\n _spendAllowance(from, spender, amount);\\n _transfer(from, to, amount);\\n return true;\\n }\\n\\n /**\\n * @dev Atomically increases the allowance granted to `spender` by the caller.\\n *\\n * This is an alternative to {approve} that can be used as a mitigation for\\n * problems described in {IERC20-approve}.\\n *\\n * Emits an {Approval} event indicating the updated allowance.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n */\\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\\n address owner = _msgSender();\\n _approve(owner, spender, allowance(owner, spender) + addedValue);\\n return true;\\n }\\n\\n /**\\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\\n *\\n * This is an alternative to {approve} that can be used as a mitigation for\\n * problems described in {IERC20-approve}.\\n *\\n * Emits an {Approval} event indicating the updated allowance.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `spender` must have allowance for the caller of at least\\n * `subtractedValue`.\\n */\\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\\n address owner = _msgSender();\\n uint256 currentAllowance = allowance(owner, spender);\\n require(currentAllowance >= subtractedValue, \\\"ERC20: decreased allowance below zero\\\");\\n unchecked {\\n _approve(owner, spender, currentAllowance - subtractedValue);\\n }\\n\\n return true;\\n }\\n\\n /**\\n * @dev Moves `amount` of tokens from `from` to `to`.\\n *\\n * This internal function is equivalent to {transfer}, and can be used to\\n * e.g. implement automatic token fees, slashing mechanisms, etc.\\n *\\n * Emits a {Transfer} event.\\n *\\n * Requirements:\\n *\\n * - `from` cannot be the zero address.\\n * - `to` cannot be the zero address.\\n * - `from` must have a balance of at least `amount`.\\n */\\n function _transfer(address from, address to, uint256 amount) internal virtual {\\n require(from != address(0), \\\"ERC20: transfer from the zero address\\\");\\n require(to != address(0), \\\"ERC20: transfer to the zero address\\\");\\n\\n _beforeTokenTransfer(from, to, amount);\\n\\n uint256 fromBalance = _balances[from];\\n require(fromBalance >= amount, \\\"ERC20: transfer amount exceeds balance\\\");\\n unchecked {\\n _balances[from] = fromBalance - amount;\\n // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\\n // decrementing then incrementing.\\n _balances[to] += amount;\\n }\\n\\n emit Transfer(from, to, amount);\\n\\n _afterTokenTransfer(from, to, amount);\\n }\\n\\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements:\\n *\\n * - `account` cannot be the zero address.\\n */\\n function _mint(address account, uint256 amount) internal virtual {\\n require(account != address(0), \\\"ERC20: mint to the zero address\\\");\\n\\n _beforeTokenTransfer(address(0), account, amount);\\n\\n _totalSupply += amount;\\n unchecked {\\n // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\\n _balances[account] += amount;\\n }\\n emit Transfer(address(0), account, amount);\\n\\n _afterTokenTransfer(address(0), account, amount);\\n }\\n\\n /**\\n * @dev Destroys `amount` tokens from `account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements:\\n *\\n * - `account` cannot be the zero address.\\n * - `account` must have at least `amount` tokens.\\n */\\n function _burn(address account, uint256 amount) internal virtual {\\n require(account != address(0), \\\"ERC20: burn from the zero address\\\");\\n\\n _beforeTokenTransfer(account, address(0), amount);\\n\\n uint256 accountBalance = _balances[account];\\n require(accountBalance >= amount, \\\"ERC20: burn amount exceeds balance\\\");\\n unchecked {\\n _balances[account] = accountBalance - amount;\\n // Overflow not possible: amount <= accountBalance <= totalSupply.\\n _totalSupply -= amount;\\n }\\n\\n emit Transfer(account, address(0), amount);\\n\\n _afterTokenTransfer(account, address(0), amount);\\n }\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\\n *\\n * This internal function is equivalent to `approve`, and can be used to\\n * e.g. set automatic allowances for certain subsystems, etc.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `owner` cannot be the zero address.\\n * - `spender` cannot be the zero address.\\n */\\n function _approve(address owner, address spender, uint256 amount) internal virtual {\\n require(owner != address(0), \\\"ERC20: approve from the zero address\\\");\\n require(spender != address(0), \\\"ERC20: approve to the zero address\\\");\\n\\n _allowances[owner][spender] = amount;\\n emit Approval(owner, spender, amount);\\n }\\n\\n /**\\n * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\\n *\\n * Does not update the allowance amount in case of infinite allowance.\\n * Revert if not enough allowance is available.\\n *\\n * Might emit an {Approval} event.\\n */\\n function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\\n uint256 currentAllowance = allowance(owner, spender);\\n if (currentAllowance != type(uint256).max) {\\n require(currentAllowance >= amount, \\\"ERC20: insufficient allowance\\\");\\n unchecked {\\n _approve(owner, spender, currentAllowance - amount);\\n }\\n }\\n }\\n\\n /**\\n * @dev Hook that is called before any transfer of tokens. This includes\\n * minting and burning.\\n *\\n * Calling conditions:\\n *\\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\\n * will be transferred to `to`.\\n * - when `from` is zero, `amount` tokens will be minted for `to`.\\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\\n * - `from` and `to` are never both zero.\\n *\\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\\n */\\n function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\\n\\n /**\\n * @dev Hook that is called after any transfer of tokens. This includes\\n * minting and burning.\\n *\\n * Calling conditions:\\n *\\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\\n * has been transferred to `to`.\\n * - when `from` is zero, `amount` tokens have been minted for `to`.\\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\\n * - `from` and `to` are never both zero.\\n *\\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\\n */\\n function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\\n}\\n\",\"keccak256\":\"0xa56ca923f70c1748830700250b19c61b70db9a683516dc5e216694a50445d99c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC20 standard.\\n *\\n * _Available since v4.1._\\n */\\ninterface IERC20Metadata is IERC20 {\\n /**\\n * @dev Returns the name of the token.\\n */\\n function name() external view returns (string memory);\\n\\n /**\\n * @dev Returns the symbol of the token.\\n */\\n function symbol() external view returns (string memory);\\n\\n /**\\n * @dev Returns the decimals places of the token.\\n */\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x8de418a5503946cabe331f35fe242d3201a73f67f77aaeb7110acb1f30423aca\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0xaa29b098440d0b3a131c5ecdf25ce548790c1b5ac7bf9b5c0264b6af6f7a1e0b\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Thrown if the supplied value is 0 where it is not allowed\\nerror ZeroValueNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\\n/// @notice Checks if the provided value is nonzero, reverts otherwise\\n/// @param value_ Value to check\\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\\nfunction ensureNonzeroValue(uint256 value_) pure {\\n if (value_ == 0) {\\n revert ZeroValueNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0xdb88e14d50dd21889ca3329d755673d022c47e8da005b6a545c7f69c2c4b7b86\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/token/TokenController.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { IAccessControlManagerV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\\\";\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { Ownable } from \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\n\\n/**\\n * @title TokenController\\n * @author Venus\\n * @notice TokenController contract acts as a governance and access control mechanism,\\n * allowing the owner to manage minting restrictions and blacklist certain addresses to maintain control and security within the token ecosystem.\\n * It provides a flexible framework for token-related operations.\\n */\\n\\ncontract TokenController is Ownable, Pausable {\\n /**\\n * @notice Access control manager contract address.\\n */\\n address public accessControlManager;\\n /**\\n * @notice A Mapping used to keep track of the blacklist status of addresses.\\n */\\n mapping(address => bool) internal _blacklist;\\n /**\\n * @notice A mapping is used to keep track of the maximum amount a minter is permitted to mint.\\n */\\n mapping(address => uint256) public minterToCap;\\n /**\\n * @notice A Mapping used to keep track of the amount i.e already minted by minter.\\n */\\n mapping(address => uint256) public minterToMintedAmount;\\n\\n /**\\n * @notice Emitted when the blacklist status of a user is updated.\\n */\\n event BlacklistUpdated(address indexed user, bool value);\\n /**\\n * @notice Emitted when the minting limit for a minter is increased.\\n */\\n event MintLimitIncreased(address indexed minter, uint256 newLimit);\\n /**\\n * @notice Emitted when the minting limit for a minter is decreased.\\n */\\n event MintLimitDecreased(address indexed minter, uint256 newLimit);\\n /**\\n * @notice Emitted when the minting cap for a minter is changed.\\n */\\n event MintCapChanged(address indexed minter, uint256 amount);\\n /**\\n * @notice Emitted when the address of the access control manager of the contract is updated.\\n */\\n event NewAccessControlManager(address indexed oldAccessControlManager, address indexed newAccessControlManager);\\n /**\\n * @notice Emitted when all minted tokens are migrated from one minter to another.\\n */\\n event MintedTokensMigrated(address indexed source, address indexed destination);\\n\\n /**\\n * @notice This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\\n */\\n error MintLimitExceed();\\n /**\\n * @notice This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\\n */\\n error AccountBlacklisted(address user);\\n /**\\n * @notice This error is used to indicate that sender is not allowed to perform this action.\\n */\\n error Unauthorized();\\n /**\\n * @notice This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\\n */\\n error NewCapNotGreaterThanMintedTokens();\\n /**\\n * @notice This error is used to indicate that the addresses must be different.\\n */\\n error AddressesMustDiffer();\\n /**\\n * @notice This error is used to indicate that the minter did not mint the required amount of tokens.\\n */\\n error MintedAmountExceed();\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n * @custom:error ZeroAddressNotAllowed is thrown when accessControlManager contract address is zero.\\n */\\n constructor(address accessControlManager_) {\\n ensureNonzeroAddress(accessControlManager_);\\n accessControlManager = accessControlManager_;\\n }\\n\\n /**\\n * @notice Pauses Token\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function pause() external {\\n _ensureAllowed(\\\"pause()\\\");\\n _pause();\\n }\\n\\n /**\\n * @notice Resumes Token\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function unpause() external {\\n _ensureAllowed(\\\"unpause()\\\");\\n _unpause();\\n }\\n\\n /**\\n * @notice Function to update blacklist.\\n * @param user_ User address to be affected.\\n * @param value_ Boolean to toggle value.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits BlacklistUpdated event.\\n */\\n function updateBlacklist(address user_, bool value_) external {\\n _ensureAllowed(\\\"updateBlacklist(address,bool)\\\");\\n _blacklist[user_] = value_;\\n emit BlacklistUpdated(user_, value_);\\n }\\n\\n /**\\n * @notice Sets the minting cap for minter.\\n * @param minter_ Minter address.\\n * @param amount_ Cap for the minter.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintCapChanged.\\n */\\n function setMintCap(address minter_, uint256 amount_) external {\\n _ensureAllowed(\\\"setMintCap(address,uint256)\\\");\\n\\n if (amount_ < minterToMintedAmount[minter_]) {\\n revert NewCapNotGreaterThanMintedTokens();\\n }\\n\\n minterToCap[minter_] = amount_;\\n emit MintCapChanged(minter_, amount_);\\n }\\n\\n /**\\n * @notice Sets the address of the access control manager of this contract.\\n * @dev Admin function to set the access control address.\\n * @param newAccessControlAddress_ New address for the access control.\\n * @custom:access Only owner.\\n * @custom:event Emits NewAccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\\n */\\n function setAccessControlManager(address newAccessControlAddress_) external onlyOwner {\\n ensureNonzeroAddress(newAccessControlAddress_);\\n emit NewAccessControlManager(accessControlManager, newAccessControlAddress_);\\n accessControlManager = newAccessControlAddress_;\\n }\\n\\n /**\\n * @notice Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\\n * @param source_ Minter address to migrate tokens from.\\n * @param destination_ Minter address to migrate tokens to.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error MintLimitExceed is thrown when the minting limit exceeds the cap after migration.\\n * @custom:error AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\\n * @custom:event Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.\\n * @custom:event Emits MintedTokensMigrated.\\n */\\n function migrateMinterTokens(address source_, address destination_) external {\\n _ensureAllowed(\\\"migrateMinterTokens(address,address)\\\");\\n\\n if (source_ == destination_) {\\n revert AddressesMustDiffer();\\n }\\n\\n uint256 sourceCap = minterToCap[source_];\\n uint256 destinationCap = minterToCap[destination_];\\n\\n uint256 sourceMinted = minterToMintedAmount[source_];\\n uint256 destinationMinted = minterToMintedAmount[destination_];\\n uint256 newDestinationMinted = destinationMinted + sourceMinted;\\n\\n if (newDestinationMinted > destinationCap) {\\n revert MintLimitExceed();\\n }\\n\\n minterToMintedAmount[source_] = 0;\\n minterToMintedAmount[destination_] = newDestinationMinted;\\n uint256 availableLimit;\\n unchecked {\\n availableLimit = destinationCap - newDestinationMinted;\\n }\\n\\n emit MintLimitDecreased(destination_, availableLimit);\\n emit MintLimitIncreased(source_, sourceCap);\\n emit MintedTokensMigrated(source_, destination_);\\n }\\n\\n /**\\n * @notice Returns the blacklist status of the address.\\n * @param user_ Address of user to check blacklist status.\\n * @return bool status of blacklist.\\n */\\n function isBlackListed(address user_) external view returns (bool) {\\n return _blacklist[user_];\\n }\\n\\n /**\\n * @dev Checks the minter cap and eligibility of receiver to receive tokens.\\n * @param from_ Minter address.\\n * @param to_ Receiver address.\\n * @param amount_ Amount to be mint.\\n * @custom:error MintLimitExceed is thrown when minting limit exceeds the cap.\\n * @custom:event Emits MintLimitDecreased with minter address and available limits.\\n */\\n function _isEligibleToMint(address from_, address to_, uint256 amount_) internal {\\n uint256 mintingCap = minterToCap[from_];\\n uint256 totalMintedOld = minterToMintedAmount[from_];\\n uint256 totalMintedNew = totalMintedOld + amount_;\\n\\n if (totalMintedNew > mintingCap) {\\n revert MintLimitExceed();\\n }\\n minterToMintedAmount[from_] = totalMintedNew;\\n uint256 availableLimit;\\n unchecked {\\n availableLimit = mintingCap - totalMintedNew;\\n }\\n emit MintLimitDecreased(from_, availableLimit);\\n }\\n\\n /**\\n * @dev This is post hook of burn function, increases minting limit of the minter.\\n * @param from_ Minter address.\\n * @param amount_ Amount burned.\\n * @custom:error MintedAmountExceed is thrown when `amount_` is greater than the tokens minted by `from_`.\\n * @custom:event Emits MintLimitIncreased with minter address and availabe limit.\\n */\\n function _increaseMintLimit(address from_, uint256 amount_) internal {\\n uint256 totalMintedOld = minterToMintedAmount[from_];\\n\\n if (totalMintedOld < amount_) {\\n revert MintedAmountExceed();\\n }\\n\\n uint256 totalMintedNew;\\n unchecked {\\n totalMintedNew = totalMintedOld - amount_;\\n }\\n minterToMintedAmount[from_] = totalMintedNew;\\n uint256 availableLimit = minterToCap[from_] - totalMintedNew;\\n emit MintLimitIncreased(from_, availableLimit);\\n }\\n\\n /**\\n * @dev Checks the caller is allowed to call the specified fuction.\\n * @param functionSig_ Function signatureon which access is to be checked.\\n * @custom:error Unauthorized, thrown when unauthorised user try to access function.\\n */\\n function _ensureAllowed(string memory functionSig_) internal view {\\n if (!IAccessControlManagerV8(accessControlManager).isAllowedToCall(msg.sender, functionSig_)) {\\n revert Unauthorized();\\n }\\n }\\n}\\n\",\"keccak256\":\"0xae9daea7f260ac111e0855fc1f9c904623f3ab8a253fb3b060519a8384f95667\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/token/XVS.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { ERC20 } from \\\"@openzeppelin/contracts/token/ERC20/ERC20.sol\\\";\\n\\nimport { TokenController } from \\\"./TokenController.sol\\\";\\n\\n/**\\n * @title XVS\\n * @author Venus\\n * @notice XVS contract serves as a customized ERC-20 token with additional minting and burning functionality.\\n * It also incorporates access control features provided by the \\\"TokenController\\\" contract to ensure proper governance and restrictions on minting and burning operations.\\n */\\n\\ncontract XVS is ERC20, TokenController {\\n constructor(address accessControlManager_) ERC20(\\\"Venus XVS\\\", \\\"XVS\\\") TokenController(accessControlManager_) {}\\n\\n /**\\n * @notice Creates `amount_` tokens and assigns them to `account_`, increasing\\n * the total supply. Checks access and eligibility.\\n * @param account_ Address to which tokens are assigned.\\n * @param amount_ Amount of tokens to be assigned.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintLimitDecreased with new available limit.\\n * @custom:error MintLimitExceed is thrown when minting amount exceeds the maximum cap.\\n */\\n function mint(address account_, uint256 amount_) external whenNotPaused {\\n _ensureAllowed(\\\"mint(address,uint256)\\\");\\n _isEligibleToMint(msg.sender, account_, amount_);\\n _mint(account_, amount_);\\n }\\n\\n /**\\n * @notice Destroys `amount_` tokens from `account_`, reducing the\\n * total supply. Checks access and eligibility.\\n * @param account_ Address from which tokens be destroyed.\\n * @param amount_ Amount of tokens to be destroyed.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:event Emits MintLimitIncreased with new available limit.\\n */\\n function burn(address account_, uint256 amount_) external whenNotPaused {\\n _ensureAllowed(\\\"burn(address,uint256)\\\");\\n _burn(account_, amount_);\\n _increaseMintLimit(msg.sender, amount_);\\n }\\n\\n /**\\n * @notice Hook that is called before any transfer of tokens. This includes\\n * minting and burning.\\n * @param from_ Address of account from which tokens are to be transferred.\\n * @param to_ Address of the account to which tokens are to be transferred.\\n * @param amount_ The amount of tokens to be transferred.\\n * @custom:error AccountBlacklisted is thrown when either `from` or `to` address is blacklisted.\\n */\\n function _beforeTokenTransfer(address from_, address to_, uint256 amount_) internal override whenNotPaused {\\n if (_blacklist[to_]) {\\n revert AccountBlacklisted(to_);\\n }\\n if (_blacklist[from_]) {\\n revert AccountBlacklisted(from_);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xd268c178725dee5da810df33bb1fae7e118df2773af3aed0acac29582b63ef52\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x608060405234801561001057600080fd5b50604051611a3b380380611a3b83398101604081905261002f9161015f565b806040518060400160405280600981526020016856656e75732058565360b81b8152506040518060400160405280600381526020016258565360e81b815250816003908161007d9190610230565b50600461008a8282610230565b5050506100a361009e6100df60201b60201c565b6100e3565b6005805460ff60a01b191690556100b981610135565b600680546001600160a01b0319166001600160a01b0392909216919091179055506102ef565b3390565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6001600160a01b03811661015c576040516342bcdf7f60e11b815260040160405180910390fd5b50565b60006020828403121561017157600080fd5b81516001600160a01b038116811461018857600080fd5b9392505050565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806101b957607f821691505b6020821081036101d957634e487b7160e01b600052602260045260246000fd5b50919050565b601f82111561022b576000816000526020600020601f850160051c810160208610156102085750805b601f850160051c820191505b8181101561022757828155600101610214565b5050505b505050565b81516001600160401b038111156102495761024961018f565b61025d8161025784546101a5565b846101df565b602080601f831160018114610292576000841561027a5750858301515b600019600386901b1c1916600185901b178555610227565b600085815260208120601f198616915b828110156102c1578886015182559484019460019091019084016102a2565b50858210156102df5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b61173d806102fe6000396000f3fe608060405234801561001057600080fd5b50600436106101a95760003560e01c80637b517334116100f9578063a9059cbb11610097578063d89e2dac11610071578063d89e2dac14610390578063dd62ed3e146103a3578063e47d6060146103b6578063f2fde38b146103e257600080fd5b8063a9059cbb14610357578063b4a0bdf31461036a578063c06abe771461037d57600080fd5b80639155e083116100d35780639155e0831461031657806395d89b41146103295780639dc29fac14610331578063a457c2d71461034457600080fd5b80637b517334146102c95780638456cb59146102e95780638da5cb5b146102f157600080fd5b8063391efe121161016657806340c10f191161014057806340c10f19146102735780635c975abb1461028657806370a0823114610298578063715018a6146102c157600080fd5b8063391efe121461023857806339509351146102585780633f4ba83a1461026b57600080fd5b806306fdde03146101ae578063095ea7b3146101cc5780630e32cb86146101ef57806318160ddd1461020457806323b872dd14610216578063313ce56714610229575b600080fd5b6101b66103f5565b6040516101c391906114f5565b60405180910390f35b6101df6101da36600461152b565b610487565b60405190151581526020016101c3565b6102026101fd366004611555565b6104a1565b005b6002545b6040519081526020016101c3565b6101df610224366004611570565b61050e565b604051601281526020016101c3565b610208610246366004611555565b60086020526000908152604090205481565b6101df61026636600461152b565b610532565b610202610554565b61020261028136600461152b565b610588565b600554600160a01b900460ff166101df565b6102086102a6366004611555565b6001600160a01b031660009081526020819052604090205490565b6102026105df565b6102086102d7366004611555565b60096020526000908152604090205481565b6102026105f1565b6005546001600160a01b03165b6040516001600160a01b0390911681526020016101c3565b6102026103243660046115ba565b610621565b6101b66106bf565b61020261033f36600461152b565b6106ce565b6101df61035236600461152b565b610720565b6101df61036536600461152b565b6107a0565b6006546102fe906001600160a01b031681565b61020261038b36600461152b565b6107ae565b61020261039e3660046115f1565b610872565b6102086103b13660046115f1565b610a1a565b6101df6103c4366004611555565b6001600160a01b031660009081526007602052604090205460ff1690565b6102026103f0366004611555565b610a45565b60606003805461040490611624565b80601f016020809104026020016040519081016040528092919081815260200182805461043090611624565b801561047d5780601f106104525761010080835404028352916020019161047d565b820191906000526020600020905b81548152906001019060200180831161046057829003601f168201915b5050505050905090565b600033610495818585610abe565b60019150505b92915050565b6104a9610be3565b6104b281610c3d565b6006546040516001600160a01b038084169216907f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa090600090a3600680546001600160a01b0319166001600160a01b0392909216919091179055565b60003361051c858285610c64565b610527858585610cde565b506001949350505050565b6000336104958185856105458383610a1a565b61054f9190611674565b610abe565b61057e60405180604001604052806009815260200168756e7061757365282960b81b815250610e8d565b610586610f1c565b565b610590610f71565b6105c6604051806040016040528060158152602001746d696e7428616464726573732c75696e743235362960581b815250610e8d565b6105d1338383610fbe565b6105db8282611074565b5050565b6105e7610be3565b610586600061113f565b610619604051806040016040528060078152602001667061757365282960c81b815250610e8d565b610586611191565b61065f6040518060400160405280601d81526020017f757064617465426c61636b6c69737428616464726573732c626f6f6c29000000815250610e8d565b6001600160a01b038216600081815260076020908152604091829020805460ff191685151590811790915591519182527f6a12b3df6cba4203bd7fd06b816789f87de8c594299aed5717ae070fac781bac91015b60405180910390a25050565b60606004805461040490611624565b6106d6610f71565b61070c604051806040016040528060158152602001746275726e28616464726573732c75696e743235362960581b815250610e8d565b61071682826111d4565b6105db338261130f565b6000338161072e8286610a1a565b9050838110156107935760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6105278286868403610abe565b600033610495818585610cde565b6107ec6040518060400160405280601b81526020017f7365744d696e7443617028616464726573732c75696e74323536290000000000815250610e8d565b6001600160a01b0382166000908152600960205260409020548110156108255760405163ce89973d60e01b815260040160405180910390fd5b6001600160a01b03821660008181526008602052604090819020839055517f01a85f4ecff52e70907e25b863010bca98a9458d9f2fe9b3efb4c47d197e6448906106b39084815260200190565b6108936040518060600160405280602481526020016116e460249139610e8d565b806001600160a01b0316826001600160a01b0316036108c5576040516380ae98f560e01b815260040160405180910390fd5b6001600160a01b0380831660008181526008602090815260408083205494861680845281842054948452600990925280832054918352822054909161090a8383611674565b90508381111561092d57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038781166000908152600960209081526040808320839055928916808352918390208490559151838703808252927fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61910160405180910390a2876001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb876040516109c891815260200190565b60405180910390a2866001600160a01b0316886001600160a01b03167f63ce671e4a37975f0a9e340f6f72320c617a5f728b83e3860b03aa847dc26ebb60405160405180910390a35050505050505050565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b610a4d610be3565b6001600160a01b038116610ab25760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b606482015260840161078a565b610abb8161113f565b50565b6001600160a01b038316610b205760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b606482015260840161078a565b6001600160a01b038216610b815760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b606482015260840161078a565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6005546001600160a01b031633146105865760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161078a565b6001600160a01b038116610abb576040516342bcdf7f60e11b815260040160405180910390fd5b6000610c708484610a1a565b90506000198114610cd85781811015610ccb5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e6365000000604482015260640161078a565b610cd88484848403610abe565b50505050565b6001600160a01b038316610d425760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b606482015260840161078a565b6001600160a01b038216610da45760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b606482015260840161078a565b610daf8383836113cd565b6001600160a01b03831660009081526020819052604090205481811015610e275760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b606482015260840161078a565b6001600160a01b03848116600081815260208181526040808320878703905593871680835291849020805487019055925185815290927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3610cd8565b6006546040516318c5e8ab60e01b81526001600160a01b03909116906318c5e8ab90610ebf9033908590600401611687565b602060405180830381865afa158015610edc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f0091906116b3565b610abb576040516282b42960e81b815260040160405180910390fd5b610f2461145f565b6005805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600554600160a01b900460ff16156105865760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b604482015260640161078a565b6001600160a01b03831660009081526008602090815260408083205460099092528220549091610fee8483611674565b90508281111561101157604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038616600081815260096020526040908190208390555182850391907fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61906110639084815260200190565b60405180910390a250505050505050565b6001600160a01b0382166110ca5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f206164647265737300604482015260640161078a565b6110d6600083836113cd565b80600260008282546110e89190611674565b90915550506001600160a01b038216600081815260208181526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b611199610f71565b6005805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f543390565b6001600160a01b0382166112345760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b606482015260840161078a565b611240826000836113cd565b6001600160a01b038216600090815260208190526040902054818110156112b45760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b606482015260840161078a565b6001600160a01b0383166000818152602081815260408083208686039055600280548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9101610bd6565b505050565b6001600160a01b03821660009081526009602052604090205481811015611349576040516348af2f2960e11b815260040160405180910390fd5b6001600160a01b03831660009081526009602090815260408083208585039081905560089092528220549091906113819083906116d0565b9050846001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb826040516113be91815260200190565b60405180910390a25050505050565b6113d5610f71565b6001600160a01b03821660009081526007602052604090205460ff161561141a5760405163571f7b4960e01b81526001600160a01b038316600482015260240161078a565b6001600160a01b03831660009081526007602052604090205460ff161561130a5760405163571f7b4960e01b81526001600160a01b038416600482015260240161078a565b600554600160a01b900460ff166105865760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b604482015260640161078a565b6000815180845260005b818110156114d5576020818501810151868301820152016114b9565b506000602082860101526020601f19601f83011685010191505092915050565b60208152600061150860208301846114af565b9392505050565b80356001600160a01b038116811461152657600080fd5b919050565b6000806040838503121561153e57600080fd5b6115478361150f565b946020939093013593505050565b60006020828403121561156757600080fd5b6115088261150f565b60008060006060848603121561158557600080fd5b61158e8461150f565b925061159c6020850161150f565b9150604084013590509250925092565b8015158114610abb57600080fd5b600080604083850312156115cd57600080fd5b6115d68361150f565b915060208301356115e6816115ac565b809150509250929050565b6000806040838503121561160457600080fd5b61160d8361150f565b915061161b6020840161150f565b90509250929050565b600181811c9082168061163857607f821691505b60208210810361165857634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b8082018082111561049b5761049b61165e565b6001600160a01b03831681526040602082018190526000906116ab908301846114af565b949350505050565b6000602082840312156116c557600080fd5b8151611508816115ac565b8181038181111561049b5761049b61165e56fe6d6967726174654d696e746572546f6b656e7328616464726573732c6164647265737329a2646970667358221220a1e16fcdda42e36f69f1b86faae54c70a14c6a62109fffaf251650ec2be02ca664736f6c63430008190033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106101a95760003560e01c80637b517334116100f9578063a9059cbb11610097578063d89e2dac11610071578063d89e2dac14610390578063dd62ed3e146103a3578063e47d6060146103b6578063f2fde38b146103e257600080fd5b8063a9059cbb14610357578063b4a0bdf31461036a578063c06abe771461037d57600080fd5b80639155e083116100d35780639155e0831461031657806395d89b41146103295780639dc29fac14610331578063a457c2d71461034457600080fd5b80637b517334146102c95780638456cb59146102e95780638da5cb5b146102f157600080fd5b8063391efe121161016657806340c10f191161014057806340c10f19146102735780635c975abb1461028657806370a0823114610298578063715018a6146102c157600080fd5b8063391efe121461023857806339509351146102585780633f4ba83a1461026b57600080fd5b806306fdde03146101ae578063095ea7b3146101cc5780630e32cb86146101ef57806318160ddd1461020457806323b872dd14610216578063313ce56714610229575b600080fd5b6101b66103f5565b6040516101c391906114f5565b60405180910390f35b6101df6101da36600461152b565b610487565b60405190151581526020016101c3565b6102026101fd366004611555565b6104a1565b005b6002545b6040519081526020016101c3565b6101df610224366004611570565b61050e565b604051601281526020016101c3565b610208610246366004611555565b60086020526000908152604090205481565b6101df61026636600461152b565b610532565b610202610554565b61020261028136600461152b565b610588565b600554600160a01b900460ff166101df565b6102086102a6366004611555565b6001600160a01b031660009081526020819052604090205490565b6102026105df565b6102086102d7366004611555565b60096020526000908152604090205481565b6102026105f1565b6005546001600160a01b03165b6040516001600160a01b0390911681526020016101c3565b6102026103243660046115ba565b610621565b6101b66106bf565b61020261033f36600461152b565b6106ce565b6101df61035236600461152b565b610720565b6101df61036536600461152b565b6107a0565b6006546102fe906001600160a01b031681565b61020261038b36600461152b565b6107ae565b61020261039e3660046115f1565b610872565b6102086103b13660046115f1565b610a1a565b6101df6103c4366004611555565b6001600160a01b031660009081526007602052604090205460ff1690565b6102026103f0366004611555565b610a45565b60606003805461040490611624565b80601f016020809104026020016040519081016040528092919081815260200182805461043090611624565b801561047d5780601f106104525761010080835404028352916020019161047d565b820191906000526020600020905b81548152906001019060200180831161046057829003601f168201915b5050505050905090565b600033610495818585610abe565b60019150505b92915050565b6104a9610be3565b6104b281610c3d565b6006546040516001600160a01b038084169216907f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa090600090a3600680546001600160a01b0319166001600160a01b0392909216919091179055565b60003361051c858285610c64565b610527858585610cde565b506001949350505050565b6000336104958185856105458383610a1a565b61054f9190611674565b610abe565b61057e60405180604001604052806009815260200168756e7061757365282960b81b815250610e8d565b610586610f1c565b565b610590610f71565b6105c6604051806040016040528060158152602001746d696e7428616464726573732c75696e743235362960581b815250610e8d565b6105d1338383610fbe565b6105db8282611074565b5050565b6105e7610be3565b610586600061113f565b610619604051806040016040528060078152602001667061757365282960c81b815250610e8d565b610586611191565b61065f6040518060400160405280601d81526020017f757064617465426c61636b6c69737428616464726573732c626f6f6c29000000815250610e8d565b6001600160a01b038216600081815260076020908152604091829020805460ff191685151590811790915591519182527f6a12b3df6cba4203bd7fd06b816789f87de8c594299aed5717ae070fac781bac91015b60405180910390a25050565b60606004805461040490611624565b6106d6610f71565b61070c604051806040016040528060158152602001746275726e28616464726573732c75696e743235362960581b815250610e8d565b61071682826111d4565b6105db338261130f565b6000338161072e8286610a1a565b9050838110156107935760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6105278286868403610abe565b600033610495818585610cde565b6107ec6040518060400160405280601b81526020017f7365744d696e7443617028616464726573732c75696e74323536290000000000815250610e8d565b6001600160a01b0382166000908152600960205260409020548110156108255760405163ce89973d60e01b815260040160405180910390fd5b6001600160a01b03821660008181526008602052604090819020839055517f01a85f4ecff52e70907e25b863010bca98a9458d9f2fe9b3efb4c47d197e6448906106b39084815260200190565b6108936040518060600160405280602481526020016116e460249139610e8d565b806001600160a01b0316826001600160a01b0316036108c5576040516380ae98f560e01b815260040160405180910390fd5b6001600160a01b0380831660008181526008602090815260408083205494861680845281842054948452600990925280832054918352822054909161090a8383611674565b90508381111561092d57604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038781166000908152600960209081526040808320839055928916808352918390208490559151838703808252927fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61910160405180910390a2876001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb876040516109c891815260200190565b60405180910390a2866001600160a01b0316886001600160a01b03167f63ce671e4a37975f0a9e340f6f72320c617a5f728b83e3860b03aa847dc26ebb60405160405180910390a35050505050505050565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b610a4d610be3565b6001600160a01b038116610ab25760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b606482015260840161078a565b610abb8161113f565b50565b6001600160a01b038316610b205760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b606482015260840161078a565b6001600160a01b038216610b815760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b606482015260840161078a565b6001600160a01b0383811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6005546001600160a01b031633146105865760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161078a565b6001600160a01b038116610abb576040516342bcdf7f60e11b815260040160405180910390fd5b6000610c708484610a1a565b90506000198114610cd85781811015610ccb5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e6365000000604482015260640161078a565b610cd88484848403610abe565b50505050565b6001600160a01b038316610d425760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b606482015260840161078a565b6001600160a01b038216610da45760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b606482015260840161078a565b610daf8383836113cd565b6001600160a01b03831660009081526020819052604090205481811015610e275760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b606482015260840161078a565b6001600160a01b03848116600081815260208181526040808320878703905593871680835291849020805487019055925185815290927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3610cd8565b6006546040516318c5e8ab60e01b81526001600160a01b03909116906318c5e8ab90610ebf9033908590600401611687565b602060405180830381865afa158015610edc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f0091906116b3565b610abb576040516282b42960e81b815260040160405180910390fd5b610f2461145f565b6005805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600554600160a01b900460ff16156105865760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b604482015260640161078a565b6001600160a01b03831660009081526008602090815260408083205460099092528220549091610fee8483611674565b90508281111561101157604051634f2dbd1d60e01b815260040160405180910390fd5b6001600160a01b038616600081815260096020526040908190208390555182850391907fbe214d1fa2403a39be9a36c9f4b45125eba30bf27a8b56a619baf00493ad3e61906110639084815260200190565b60405180910390a250505050505050565b6001600160a01b0382166110ca5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f206164647265737300604482015260640161078a565b6110d6600083836113cd565b80600260008282546110e89190611674565b90915550506001600160a01b038216600081815260208181526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b611199610f71565b6005805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f543390565b6001600160a01b0382166112345760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b606482015260840161078a565b611240826000836113cd565b6001600160a01b038216600090815260208190526040902054818110156112b45760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b606482015260840161078a565b6001600160a01b0383166000818152602081815260408083208686039055600280548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9101610bd6565b505050565b6001600160a01b03821660009081526009602052604090205481811015611349576040516348af2f2960e11b815260040160405180910390fd5b6001600160a01b03831660009081526009602090815260408083208585039081905560089092528220549091906113819083906116d0565b9050846001600160a01b03167f0831a8ba59684daef8a957d2bd2d943e233993771429e9a17b71ddb1cea35cdb826040516113be91815260200190565b60405180910390a25050505050565b6113d5610f71565b6001600160a01b03821660009081526007602052604090205460ff161561141a5760405163571f7b4960e01b81526001600160a01b038316600482015260240161078a565b6001600160a01b03831660009081526007602052604090205460ff161561130a5760405163571f7b4960e01b81526001600160a01b038416600482015260240161078a565b600554600160a01b900460ff166105865760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b604482015260640161078a565b6000815180845260005b818110156114d5576020818501810151868301820152016114b9565b506000602082860101526020601f19601f83011685010191505092915050565b60208152600061150860208301846114af565b9392505050565b80356001600160a01b038116811461152657600080fd5b919050565b6000806040838503121561153e57600080fd5b6115478361150f565b946020939093013593505050565b60006020828403121561156757600080fd5b6115088261150f565b60008060006060848603121561158557600080fd5b61158e8461150f565b925061159c6020850161150f565b9150604084013590509250925092565b8015158114610abb57600080fd5b600080604083850312156115cd57600080fd5b6115d68361150f565b915060208301356115e6816115ac565b809150509250929050565b6000806040838503121561160457600080fd5b61160d8361150f565b915061161b6020840161150f565b90509250929050565b600181811c9082168061163857607f821691505b60208210810361165857634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b8082018082111561049b5761049b61165e565b6001600160a01b03831681526040602082018190526000906116ab908301846114af565b949350505050565b6000602082840312156116c557600080fd5b8151611508816115ac565b8181038181111561049b5761049b61165e56fe6d6967726174654d696e746572546f6b656e7328616464726573732c6164647265737329a2646970667358221220a1e16fcdda42e36f69f1b86faae54c70a14c6a62109fffaf251650ec2be02ca664736f6c63430008190033", "devdoc": { "author": "Venus", + "events": { + "Approval(address,address,uint256)": { + "details": "Emitted when the allowance of a `spender` for an `owner` is set by a call to {approve}. `value` is the new allowance." + }, + "Paused(address)": { + "details": "Emitted when the pause is triggered by `account`." + }, + "Transfer(address,address,uint256)": { + "details": "Emitted when `value` tokens are moved from one account (`from`) to another (`to`). Note that `value` may be zero." + }, + "Unpaused(address)": { + "details": "Emitted when the pause is lifted by `account`." + } + }, "kind": "dev", "methods": { "allowance(address,address)": { @@ -974,7 +988,7 @@ "storageLayout": { "storage": [ { - "astId": 5612, + "astId": 4833, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_balances", "offset": 0, @@ -982,7 +996,7 @@ "type": "t_mapping(t_address,t_uint256)" }, { - "astId": 5618, + "astId": 4839, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_allowances", "offset": 0, @@ -990,7 +1004,7 @@ "type": "t_mapping(t_address,t_mapping(t_address,t_uint256))" }, { - "astId": 5620, + "astId": 4841, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_totalSupply", "offset": 0, @@ -998,7 +1012,7 @@ "type": "t_uint256" }, { - "astId": 5622, + "astId": 4843, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_name", "offset": 0, @@ -1006,7 +1020,7 @@ "type": "t_string_storage" }, { - "astId": 5624, + "astId": 4845, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_symbol", "offset": 0, @@ -1014,7 +1028,7 @@ "type": "t_string_storage" }, { - "astId": 5383, + "astId": 4604, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_owner", "offset": 0, @@ -1022,7 +1036,7 @@ "type": "t_address" }, { - "astId": 5506, + "astId": 4727, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_paused", "offset": 20, @@ -1030,7 +1044,7 @@ "type": "t_bool" }, { - "astId": 11266, + "astId": 9550, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "accessControlManager", "offset": 0, @@ -1038,7 +1052,7 @@ "type": "t_address" }, { - "astId": 11271, + "astId": 9555, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "_blacklist", "offset": 0, @@ -1046,7 +1060,7 @@ "type": "t_mapping(t_address,t_bool)" }, { - "astId": 11276, + "astId": 9560, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "minterToCap", "offset": 0, @@ -1054,7 +1068,7 @@ "type": "t_mapping(t_address,t_uint256)" }, { - "astId": 11281, + "astId": 9565, "contract": "contracts/Bridge/token/XVS.sol:XVS", "label": "minterToMintedAmount", "offset": 0, diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin.json b/deployments/arbitrumsepolia/XVSBridgeAdmin.json index 838c466..8572cb5 100644 --- a/deployments/arbitrumsepolia/XVSBridgeAdmin.json +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin.json @@ -1,5 +1,5 @@ { - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "abi": [ { "anonymous": false, @@ -458,82 +458,82 @@ "type": "constructor" } ], - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "contractAddress": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "transactionIndex": 2, - "gasUsed": "1679305", - "logsBloom": "0x00000000000000000000000200000040400020000000000400800000000000040000000000000000000000000000000000000000000000000000000000008000000000000000004000000000000002000001000000000000000000000000000000000000020000040000000000000800000000800000000000000000000000400000000000000000000000000000000000000000000080000000000000800000000000000000000000000001000400000000000000800000000000000000000000000020000000000000000000040000000000000400000000000000000020000200000000000000000000000000000000000800000000000000000000000000", - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32", - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "gasUsed": "796839", + "logsBloom": "0x00000000000000000000000200000000400000000000000400800000000000040000000000000020000000000000010000000000000000000000000000008100000000000000000000000000000002000001000000000000000000000000000000000000020000000000000000000800000000800000000000000000000000400000000000000000020000000000000000000000000080000000000000800000000000000000000000000000000400000000000000800000000000000000000000000020000000000000000000040000000000000400000000000000000020000000000000000000000000000000000000000800000000400000000001000000", + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41", + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", "logs": [ { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": [ "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", - "0x000000000000000000000000d2048bd9e1d9a515cc57e270d0928b1127348ae1" + "0x0000000000000000000000003514fb2bbaf4d749af5908311b4c1867beb349cb" ], "data": "0x", - "logIndex": 4, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 1, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 5, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 2, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": ["0x66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f", - "logIndex": 6, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 3, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], "data": "0x0000000000000000000000000000000000000000000000000000000000000001", - "logIndex": 7, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 4, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a78a1df376c3ceebc5fab574fe6eddbbf76fd03e", - "logIndex": 8, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 5, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" } ], - "blockNumber": 27132301, - "cumulativeGasUsed": "3399219", + "blockNumber": 36234810, + "cumulativeGasUsed": "823530", "status": 1, "byzantium": true }, "args": [ - "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", "0xc4d66de8000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f" ], @@ -546,7 +546,7 @@ "methodName": "initialize", "args": ["0xa36AD96441cB931D8dFEAAaC97D3FaB4B39E590F"] }, - "implementation": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "implementation": "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "devdoc": { "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", "kind": "dev", diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json b/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json index 3d90a5f..989732f 100644 --- a/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin_Implementation.json @@ -1,5 +1,5 @@ { - "address": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "address": "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "abi": [ { "inputs": [ @@ -329,41 +329,46 @@ "type": "function" } ], - "transactionHash": "0x4dfe6686fb9890a60513d16b09040dd4859a2907964ee4fd300c43d1cf74cfed", + "transactionHash": "0xe01d58e6470218f16ec0022bd3dae987a9fd162e06a9404ac6f55c832d21f942", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "contractAddress": "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "transactionIndex": 3, - "gasUsed": "2496583", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000200000800400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000", - "blockHash": "0x7ab0ebc08e18039f5ba3a0a03d07fccb15aa35f801a14cc59b44b9306e555581", - "transactionHash": "0x4dfe6686fb9890a60513d16b09040dd4859a2907964ee4fd300c43d1cf74cfed", + "gasUsed": "1274969", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000008000000000200000000000000000000400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000", + "blockHash": "0x19868139232d977b619021f60f9a8656067932a34f2bf698d7d313ceea4cf0d5", + "transactionHash": "0xe01d58e6470218f16ec0022bd3dae987a9fd162e06a9404ac6f55c832d21f942", "logs": [ { "transactionIndex": 3, - "blockNumber": 27132283, - "transactionHash": "0x4dfe6686fb9890a60513d16b09040dd4859a2907964ee4fd300c43d1cf74cfed", - "address": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "blockNumber": 36234797, + "transactionHash": "0xe01d58e6470218f16ec0022bd3dae987a9fd162e06a9404ac6f55c832d21f942", + "address": "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], "data": "0x00000000000000000000000000000000000000000000000000000000000000ff", - "logIndex": 6, - "blockHash": "0x7ab0ebc08e18039f5ba3a0a03d07fccb15aa35f801a14cc59b44b9306e555581" + "logIndex": 4, + "blockHash": "0x19868139232d977b619021f60f9a8656067932a34f2bf698d7d313ceea4cf0d5" } ], - "blockNumber": 27132283, - "cumulativeGasUsed": "4260614", + "blockNumber": 36234797, + "cumulativeGasUsed": "2420675", "status": 1, "byzantium": true }, - "args": ["0xE9B66800E63888DE29c4c9131faadbDbDCfae917"], + "args": ["0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4"], "numDeployments": 1, - "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", - "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"XVSBridge_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"sender\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"calledContract\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"methodSignature\",\"type\":\"string\"}],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"string\",\"name\":\"signature\",\"type\":\"string\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"}],\"name\":\"FunctionRegistryChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferStarted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"stateMutability\":\"nonpayable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"XVSBridge\",\"outputs\":[{\"internalType\":\"contract IXVSProxyOFT\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"acceptOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"contract IAccessControlManagerV8\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"name\":\"functionRegistry\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pendingOwner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner_\",\"type\":\"address\"}],\"name\":\"transferBridgeOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string[]\",\"name\":\"signatures_\",\"type\":\"string[]\"},{\"internalType\":\"bool[]\",\"name\":\"active_\",\"type\":\"bool[]\"}],\"name\":\"upsertSignature\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"acceptOwnership()\":{\"details\":\"The new owner accepts the ownership transfer.\"},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"initialize(address)\":{\"params\":{\"accessControlManager_\":\"Address of access control manager contract.\"}},\"isTrustedRemote(uint16,bytes)\":{\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"},\"returns\":{\"_0\":\"Bool indicating whether the remote chain is trusted or not.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pendingOwner()\":{\"details\":\"Returns the address of the pending owner.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only Governance\",\"custom:event\":\"Emits NewAccessControlManager event\",\"details\":\"Admin function to set address of AccessControlManager\",\"params\":{\"accessControlManager_\":\"The new address of the AccessControlManager\"}},\"setTrustedRemoteAddress(uint16,bytes)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"}},\"transferBridgeOwnership(address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"params\":{\"newOwner_\":\"New owner of the XVS Bridge.\"}},\"transferOwnership(address)\":{\"details\":\"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.\"},\"upsertSignature(string[],bool[])\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits FunctionRegistryChanged if bool value of function changes.\",\"params\":{\"active_\":\"bool value, should be true to add function.\",\"signatures_\":\"Function signature to be added or removed.\"}}},\"stateVariables\":{\"XVSBridge\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"}},\"title\":\"XVSBridgeAdmin\",\"version\":1},\"userdoc\":{\"errors\":{\"Unauthorized(address,address,string)\":[{\"notice\":\"Thrown when the action is prohibited by AccessControlManager\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"FunctionRegistryChanged(string,bool)\":{\"notice\":\"emitted when function registry updated\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when access control manager contract address is changed\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Returns the address of the access control manager contract\"},\"functionRegistry(bytes4)\":{\"notice\":\"A mapping keeps track of function signature associated with function name string.\"},\"isTrustedRemote(uint16,bytes)\":{\"notice\":\"Returns true if remote address is trustedRemote corresponds to chainId_.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of AccessControlManager\"},\"setTrustedRemoteAddress(uint16,bytes)\":{\"notice\":\"Sets trusted remote on particular chain.\"},\"transferBridgeOwnership(address)\":{\"notice\":\"This function transfers the ownership of the bridge from this contract to new owner.\"},\"upsertSignature(string[],bool[])\":{\"notice\":\"A setter for the registry of functions that are allowed to be executed from proposals.\"}},\"notice\":\"The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT. It maintains a registry of function signatures and names, allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSBridgeAdmin.sol\":\"XVSBridgeAdmin\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OwnableUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership} and {acceptOwnership}.\\n *\\n * This module is used through inheritance. It will make available all functions\\n * from parent (Ownable).\\n */\\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\\n function __Ownable2Step_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable2Step_init_unchained() internal onlyInitializing {\\n }\\n address private _pendingOwner;\\n\\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Returns the address of the pending owner.\\n */\\n function pendingOwner() public view virtual returns (address) {\\n return _pendingOwner;\\n }\\n\\n /**\\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual override onlyOwner {\\n _pendingOwner = newOwner;\\n emit OwnershipTransferStarted(owner(), newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual override {\\n delete _pendingOwner;\\n super._transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev The new owner accepts the ownership transfer.\\n */\\n function acceptOwnership() public virtual {\\n address sender = _msgSender();\\n require(pendingOwner() == sender, \\\"Ownable2Step: caller is not the new owner\\\");\\n _transferOwnership(sender);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x84efb8889801b0ac817324aff6acc691d07bbee816b671817132911d287a8c63\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/ContextUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n function __Ownable_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable_init_unchained() internal onlyInitializing {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x4075622496acc77fd6d4de4cc30a8577a744d5c75afad33fdeacf1704d6eda98\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../../utils/AddressUpgradeable.sol\\\";\\n\\n/**\\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\\n *\\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\\n * reused. This mechanism prevents re-execution of each \\\"step\\\" but allows the creation of new initialization steps in\\n * case an upgrade adds a module that needs to be initialized.\\n *\\n * For example:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```solidity\\n * contract MyToken is ERC20Upgradeable {\\n * function initialize() initializer public {\\n * __ERC20_init(\\\"MyToken\\\", \\\"MTK\\\");\\n * }\\n * }\\n *\\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\\n * function initializeV2() reinitializer(2) public {\\n * __ERC20Permit_init(\\\"MyToken\\\");\\n * }\\n * }\\n * ```\\n *\\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\\n *\\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\\n *\\n * [CAUTION]\\n * ====\\n * Avoid leaving a contract uninitialized.\\n *\\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```\\n * /// @custom:oz-upgrades-unsafe-allow constructor\\n * constructor() {\\n * _disableInitializers();\\n * }\\n * ```\\n * ====\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n * @custom:oz-retyped-from bool\\n */\\n uint8 private _initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private _initializing;\\n\\n /**\\n * @dev Triggered when the contract has been initialized or reinitialized.\\n */\\n event Initialized(uint8 version);\\n\\n /**\\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\\n * `onlyInitializing` functions can be used to initialize parent contracts.\\n *\\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\\n * constructor.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier initializer() {\\n bool isTopLevelCall = !_initializing;\\n require(\\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n _initialized = 1;\\n if (isTopLevelCall) {\\n _initializing = true;\\n }\\n _;\\n if (isTopLevelCall) {\\n _initializing = false;\\n emit Initialized(1);\\n }\\n }\\n\\n /**\\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\\n * used to initialize parent contracts.\\n *\\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\\n * are added through upgrades and that require initialization.\\n *\\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\\n * cannot be nested. If one is invoked in the context of another, execution will revert.\\n *\\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\\n * a contract, executing them in the right order is up to the developer or operator.\\n *\\n * WARNING: setting the version to 255 will prevent any future reinitialization.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier reinitializer(uint8 version) {\\n require(!_initializing && _initialized < version, \\\"Initializable: contract is already initialized\\\");\\n _initialized = version;\\n _initializing = true;\\n _;\\n _initializing = false;\\n emit Initialized(version);\\n }\\n\\n /**\\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\\n */\\n modifier onlyInitializing() {\\n require(_initializing, \\\"Initializable: contract is not initializing\\\");\\n _;\\n }\\n\\n /**\\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\\n * through proxies.\\n *\\n * Emits an {Initialized} event the first time it is successfully executed.\\n */\\n function _disableInitializers() internal virtual {\\n require(!_initializing, \\\"Initializable: contract is initializing\\\");\\n if (_initialized != type(uint8).max) {\\n _initialized = type(uint8).max;\\n emit Initialized(type(uint8).max);\\n }\\n }\\n\\n /**\\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\\n */\\n function _getInitializedVersion() internal view returns (uint8) {\\n return _initialized;\\n }\\n\\n /**\\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\\n */\\n function _isInitializing() internal view returns (bool) {\\n return _initializing;\\n }\\n}\\n\",\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary AddressUpgradeable {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract ContextUpgradeable is Initializable {\\n function __Context_init() internal onlyInitializing {\\n }\\n\\n function __Context_init_unchained() internal onlyInitializing {\\n }\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[50] private __gap;\\n}\\n\",\"keccak256\":\"0x963ea7f0b48b032eef72fe3a7582edf78408d6f834115b9feadd673a4d5bd149\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\\\";\\nimport \\\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\\\";\\n\\nimport \\\"./IAccessControlManagerV8.sol\\\";\\n\\n/**\\n * @title AccessControlledV8\\n * @author Venus\\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\\n */\\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\\n /// @notice Access control manager contract\\n IAccessControlManagerV8 private _accessControlManager;\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n\\n /// @notice Emitted when access control manager contract address is changed\\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\\n\\n /// @notice Thrown when the action is prohibited by AccessControlManager\\n error Unauthorized(address sender, address calledContract, string methodSignature);\\n\\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\\n __Ownable2Step_init();\\n __AccessControlled_init_unchained(accessControlManager_);\\n }\\n\\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Sets the address of AccessControlManager\\n * @dev Admin function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n * @custom:event Emits NewAccessControlManager event\\n * @custom:access Only Governance\\n */\\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Returns the address of the access control manager contract\\n */\\n function accessControlManager() external view returns (IAccessControlManagerV8) {\\n return _accessControlManager;\\n }\\n\\n /**\\n * @dev Internal function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n */\\n function _setAccessControlManager(address accessControlManager_) internal {\\n require(address(accessControlManager_) != address(0), \\\"invalid acess control manager address\\\");\\n address oldAccessControlManager = address(_accessControlManager);\\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\\n }\\n\\n /**\\n * @notice Reverts if the call is not allowed by AccessControlManager\\n * @param signature Method signature\\n */\\n function _checkAccessAllowed(string memory signature) internal view {\\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\\n\\n if (!isAllowedToCall) {\\n revert Unauthorized(msg.sender, address(this), signature);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x1b805a5d09990e2c4f7839afe7726a02f8452261eb3d0d488e24129ec0a7736d\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x8adbe291d659987faf4de606736227ad9d8e1a0e284a33a6ca12b30ab2a504b2\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSBridgeAdmin.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\n\\npragma solidity 0.8.13;\\n\\nimport { AccessControlledV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { IXVSProxyOFT } from \\\"./interfaces/IXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSBridgeAdmin\\n * @author Venus\\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\\n * It maintains a registry of function signatures and names,\\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\\n */\\ncontract XVSBridgeAdmin is AccessControlledV8 {\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IXVSProxyOFT public immutable XVSBridge;\\n /**\\n * @notice A mapping keeps track of function signature associated with function name string.\\n */\\n mapping(bytes4 => string) public functionRegistry;\\n\\n /**\\n * @notice emitted when function registry updated\\n */\\n event FunctionRegistryChanged(string signature, bool active);\\n\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(address XVSBridge_) {\\n ensureNonzeroAddress(XVSBridge_);\\n XVSBridge = IXVSProxyOFT(XVSBridge_);\\n _disableInitializers();\\n }\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n */\\n function initialize(address accessControlManager_) external initializer {\\n __AccessControlled_init(accessControlManager_);\\n }\\n\\n /**\\n * @notice Invoked when called function does not exist in the contract.\\n * @return Response of low level call.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n fallback(bytes calldata data) external returns (bytes memory) {\\n string memory fun = _getFunctionName(msg.sig);\\n require(bytes(fun).length != 0, \\\"Function not found\\\");\\n _checkAccessAllowed(fun);\\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\\n require(ok, \\\"call failed\\\");\\n return res;\\n }\\n\\n /**\\n * @notice Sets trusted remote on particular chain.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n */\\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\\n _checkAccessAllowed(\\\"setTrustedRemoteAddress(uint16,bytes)\\\");\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\\n * @param signatures_ Function signature to be added or removed.\\n * @param active_ bool value, should be true to add function.\\n * @custom:access Only owner.\\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\\n */\\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\\n uint256 signatureLength = signatures_.length;\\n require(signatureLength == active_.length, \\\"Input arrays must have the same length\\\");\\n for (uint256 i; i < signatureLength; ) {\\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\\n bytes memory signature = bytes(functionRegistry[sigHash]);\\n if (active_[i] && signature.length == 0) {\\n functionRegistry[sigHash] = signatures_[i];\\n emit FunctionRegistryChanged(signatures_[i], true);\\n } else if (!active_[i] && signature.length != 0) {\\n delete functionRegistry[sigHash];\\n emit FunctionRegistryChanged(signatures_[i], false);\\n }\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /**\\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\\n * @param newOwner_ New owner of the XVS Bridge.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function transferBridgeOwnership(address newOwner_) external {\\n _checkAccessAllowed(\\\"transferBridgeOwnership(address)\\\");\\n XVSBridge.transferOwnership(newOwner_);\\n }\\n\\n /**\\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n * @return Bool indicating whether the remote chain is trusted or not.\\n */\\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @dev Returns function name string associated with function signature.\\n * @param signature_ Four bytes of function signature.\\n * @return Function signature corresponding to its hash.\\n */\\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\\n return functionRegistry[signature_];\\n }\\n\\n /**\\n * @notice Converts given bytes into address.\\n * @param b Bytes to be converted into address.\\n * @return Converted address of given bytes.\\n */\\n function bytesToAddress(bytes calldata b) private pure returns (address) {\\n return address(uint160(bytes20(b)));\\n }\\n}\\n\",\"keccak256\":\"0x3ba34b95f911e1772aca61e6daa00c4ebdb5bee61fc072ffba9e7ff3dc1262cd\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/**\\n * @title IXVSProxyOFT\\n * @author Venus\\n * @notice Interface implemented by `XVSProxyOFT`.\\n */\\ninterface IXVSProxyOFT {\\n function transferOwnership(address addr) external;\\n\\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\\n\\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\\n}\\n\",\"keccak256\":\"0x854518f3e4c2270ca52184e63dc1f9d27f2893388216ee6153e6ab8cf2d7c960\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", - "bytecode": "0x60a06040523480156200001157600080fd5b50604051620016ac380380620016ac833981016040819052620000349162000149565b6200003f816200005d565b6001600160a01b0381166080526200005662000088565b506200017b565b6001600160a01b03811662000085576040516342bcdf7f60e11b815260040160405180910390fd5b50565b600054610100900460ff1615620000f55760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161462000147576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b6000602082840312156200015c57600080fd5b81516001600160a01b03811681146200017457600080fd5b9392505050565b6080516114f9620001b3600039600081816101610152818161026c015281816105d6015281816106b70152610b2a01526114f96000f3fe608060405234801561001057600080fd5b50600436106100ea5760003560e01c806379ba50971161008c578063b4a0bdf311610066578063b4a0bdf31461031b578063c4d66de81461032c578063e30c39781461033f578063f2fde38b14610350576100ea565b806379ba5097146102ef5780638da5cb5b146102f7578063a6c3d16514610308576100ea565b80633d8b38f6116100c85780633d8b38f6146102a65780633f90b540146102c95780634bb7453e146102dc578063715018a61461023c576100ea565b80630e32cb8614610229578063180d295c1461023e57806327a020ef14610267575b600036606060006101066000356001600160e01b031916610363565b905080516000036101535760405162461bcd60e51b8152602060048201526012602482015271119d5b98dd1a5bdb881b9bdd08199bdd5b9960721b60448201526064015b60405180910390fd5b61015c81610410565b6000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316868660405161019992919061106b565b6000604051808303816000865af19150503d80600081146101d6576040519150601f19603f3d011682016040523d82523d6000602084013e6101db565b606091505b50915091508161021b5760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161014a565b805195506020019350505050f35b61023c61023736600461107b565b6104ae565b005b61025161024c3660046110ab565b6104c2565b60405161025e9190611122565b60405180910390f35b61028e7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161025e565b6102b96102b4366004611135565b61055c565b604051901515815260200161025e565b61023c6102d736600461107b565b61065a565b61023c6102ea36600461120d565b610716565b61023c610a1f565b6033546001600160a01b031661028e565b61023c610316366004611135565b610a96565b6097546001600160a01b031661028e565b61023c61033a36600461107b565b610b9a565b6065546001600160a01b031661028e565b61023c61035e36600461107b565b610cad565b6001600160e01b03198116600090815260c96020526040902080546060919061038b90611279565b80601f01602080910402602001604051908101604052809291908181526020018280546103b790611279565b80156104045780601f106103d957610100808354040283529160200191610404565b820191906000526020600020905b8154815290600101906020018083116103e757829003601f168201915b50505050509050919050565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061044390339086906004016112b3565b602060405180830381865afa158015610460573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061048491906112e5565b9050806104aa57333083604051634a3fa29360e01b815260040161014a93929190611302565b5050565b6104b6610d1e565b6104bf81610d78565b50565b60c960205260009081526040902080546104db90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461050790611279565b80156105545780601f1061052957610100808354040283529160200191610554565b820191906000526020600020905b81548152906001019060200180831161053757829003601f168201915b505050505081565b60008361ffff166000036105ad5760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b6105bf6105ba8484610e36565b610e4c565b604051631ec59c7b60e11b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633d8b38f69061060f90879087908790600401611360565b6020604051808303816000875af115801561062e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061065291906112e5565b949350505050565b6106986040518060400160405280602081526020017f7472616e736665724272696467654f776e657273686970286164647265737329815250610410565b60405163f2fde38b60e01b81526001600160a01b0382811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063f2fde38b90602401600060405180830381600087803b1580156106fb57600080fd5b505af115801561070f573d6000803e3d6000fd5b5050505050565b61071e610d1e565b8281811461077d5760405162461bcd60e51b815260206004820152602660248201527f496e70757420617272617973206d7573742068617665207468652073616d65206044820152650d8cadccee8d60d31b606482015260840161014a565b60005b81811015610a1557600086868381811061079c5761079c61137e565b90506020028101906107ae9190611394565b6040516107bc92919061106b565b60408051918290039091206001600160e01b03198116600090815260c96020529182208054919350906107ee90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461081a90611279565b80156108675780601f1061083c57610100808354040283529160200191610867565b820191906000526020600020905b81548152906001019060200180831161084a57829003601f168201915b505050505090508585848181106108805761088061137e565b905060200201602081019061089591906113db565b80156108a057508051155b15610951578787848181106108b7576108b761137e565b90506020028101906108c99190611394565b6001600160e01b03198416600090815260c9602052604090206108ed929091610f9c565b507f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109215761092161137e565b90506020028101906109339190611394565b6001604051610944939291906113f8565b60405180910390a1610a0b565b8585848181106109635761096361137e565b905060200201602081019061097891906113db565b1580156109855750805115155b15610a0b576001600160e01b03198216600090815260c9602052604081206109ac91611020565b7f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109df576109df61137e565b90506020028101906109f19190611394565b6000604051610a02939291906113f8565b60405180910390a15b5050600101610780565b505050505050565b565b60655433906001600160a01b03168114610a8d5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840161014a565b6104bf81610e73565b610ab760405180606001604052806025815260200161149f60259139610410565b8261ffff16600003610b065760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b610b136105ba8383610e36565b60405163a6c3d16560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063a6c3d16590610b6390869086908690600401611360565b600060405180830381600087803b158015610b7d57600080fd5b505af1158015610b91573d6000803e3d6000fd5b50505050505050565b600054610100900460ff1615808015610bba5750600054600160ff909116105b80610bd45750303b158015610bd4575060005460ff166001145b610c375760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161014a565b6000805460ff191660011790558015610c5a576000805461ff0019166101001790555b610c6382610e8c565b80156104aa576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020015b60405180910390a15050565b610cb5610d1e565b606580546001600160a01b0383166001600160a01b03199091168117909155610ce66033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b03163314610a1d5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161014a565b6001600160a01b038116610ddc5760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b606482015260840161014a565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa09101610ca1565b6000610e42828461141e565b60601c9392505050565b6001600160a01b0381166104bf576040516342bcdf7f60e11b815260040160405180910390fd5b606580546001600160a01b03191690556104bf81610ec4565b600054610100900460ff16610eb35760405162461bcd60e51b815260040161014a90611453565b610ebb610f16565b6104bf81610f45565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff16610f3d5760405162461bcd60e51b815260040161014a90611453565b610a1d610f6c565b600054610100900460ff166104b65760405162461bcd60e51b815260040161014a90611453565b600054610100900460ff16610f935760405162461bcd60e51b815260040161014a90611453565b610a1d33610e73565b828054610fa890611279565b90600052602060002090601f016020900481019282610fca5760008555611010565b82601f10610fe35782800160ff19823516178555611010565b82800160010185558215611010579182015b82811115611010578235825591602001919060010190610ff5565b5061101c929150611056565b5090565b50805461102c90611279565b6000825580601f1061103c575050565b601f0160209004906000526020600020908101906104bf91905b5b8082111561101c5760008155600101611057565b8183823760009101908152919050565b60006020828403121561108d57600080fd5b81356001600160a01b03811681146110a457600080fd5b9392505050565b6000602082840312156110bd57600080fd5b81356001600160e01b0319811681146110a457600080fd5b6000815180845260005b818110156110fb576020818501810151868301820152016110df565b8181111561110d576000602083870101525b50601f01601f19169290920160200192915050565b6020815260006110a460208301846110d5565b60008060006040848603121561114a57600080fd5b833561ffff8116811461115c57600080fd5b9250602084013567ffffffffffffffff8082111561117957600080fd5b818601915086601f83011261118d57600080fd5b81358181111561119c57600080fd5b8760208285010111156111ae57600080fd5b6020830194508093505050509250925092565b60008083601f8401126111d357600080fd5b50813567ffffffffffffffff8111156111eb57600080fd5b6020830191508360208260051b850101111561120657600080fd5b9250929050565b6000806000806040858703121561122357600080fd5b843567ffffffffffffffff8082111561123b57600080fd5b611247888389016111c1565b9096509450602087013591508082111561126057600080fd5b5061126d878288016111c1565b95989497509550505050565b600181811c9082168061128d57607f821691505b6020821081036112ad57634e487b7160e01b600052602260045260246000fd5b50919050565b6001600160a01b0383168152604060208201819052600090610652908301846110d5565b80151581146104bf57600080fd5b6000602082840312156112f757600080fd5b81516110a4816112d7565b6001600160a01b0384811682528316602082015260606040820181905260009061132e908301846110d5565b95945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff8416815260406020820152600061132e604083018486611337565b634e487b7160e01b600052603260045260246000fd5b6000808335601e198436030181126113ab57600080fd5b83018035915067ffffffffffffffff8211156113c657600080fd5b60200191503681900382131561120657600080fd5b6000602082840312156113ed57600080fd5b81356110a4816112d7565b60408152600061140c604083018587611337565b90508215156020830152949350505050565b6bffffffffffffffffffffffff19813581811691601485101561144b5780818660140360031b1b83161692505b505092915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b60608201526080019056fe7365745472757374656452656d6f7465416464726573732875696e7431362c627974657329a2646970667358221220ac99e6bde2c9eb9bdd52a744515930950de54cf45081e77327e35b07ad11a96064736f6c634300080d0033", - "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100ea5760003560e01c806379ba50971161008c578063b4a0bdf311610066578063b4a0bdf31461031b578063c4d66de81461032c578063e30c39781461033f578063f2fde38b14610350576100ea565b806379ba5097146102ef5780638da5cb5b146102f7578063a6c3d16514610308576100ea565b80633d8b38f6116100c85780633d8b38f6146102a65780633f90b540146102c95780634bb7453e146102dc578063715018a61461023c576100ea565b80630e32cb8614610229578063180d295c1461023e57806327a020ef14610267575b600036606060006101066000356001600160e01b031916610363565b905080516000036101535760405162461bcd60e51b8152602060048201526012602482015271119d5b98dd1a5bdb881b9bdd08199bdd5b9960721b60448201526064015b60405180910390fd5b61015c81610410565b6000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316868660405161019992919061106b565b6000604051808303816000865af19150503d80600081146101d6576040519150601f19603f3d011682016040523d82523d6000602084013e6101db565b606091505b50915091508161021b5760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161014a565b805195506020019350505050f35b61023c61023736600461107b565b6104ae565b005b61025161024c3660046110ab565b6104c2565b60405161025e9190611122565b60405180910390f35b61028e7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161025e565b6102b96102b4366004611135565b61055c565b604051901515815260200161025e565b61023c6102d736600461107b565b61065a565b61023c6102ea36600461120d565b610716565b61023c610a1f565b6033546001600160a01b031661028e565b61023c610316366004611135565b610a96565b6097546001600160a01b031661028e565b61023c61033a36600461107b565b610b9a565b6065546001600160a01b031661028e565b61023c61035e36600461107b565b610cad565b6001600160e01b03198116600090815260c96020526040902080546060919061038b90611279565b80601f01602080910402602001604051908101604052809291908181526020018280546103b790611279565b80156104045780601f106103d957610100808354040283529160200191610404565b820191906000526020600020905b8154815290600101906020018083116103e757829003601f168201915b50505050509050919050565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061044390339086906004016112b3565b602060405180830381865afa158015610460573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061048491906112e5565b9050806104aa57333083604051634a3fa29360e01b815260040161014a93929190611302565b5050565b6104b6610d1e565b6104bf81610d78565b50565b60c960205260009081526040902080546104db90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461050790611279565b80156105545780601f1061052957610100808354040283529160200191610554565b820191906000526020600020905b81548152906001019060200180831161053757829003601f168201915b505050505081565b60008361ffff166000036105ad5760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b6105bf6105ba8484610e36565b610e4c565b604051631ec59c7b60e11b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633d8b38f69061060f90879087908790600401611360565b6020604051808303816000875af115801561062e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061065291906112e5565b949350505050565b6106986040518060400160405280602081526020017f7472616e736665724272696467654f776e657273686970286164647265737329815250610410565b60405163f2fde38b60e01b81526001600160a01b0382811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063f2fde38b90602401600060405180830381600087803b1580156106fb57600080fd5b505af115801561070f573d6000803e3d6000fd5b5050505050565b61071e610d1e565b8281811461077d5760405162461bcd60e51b815260206004820152602660248201527f496e70757420617272617973206d7573742068617665207468652073616d65206044820152650d8cadccee8d60d31b606482015260840161014a565b60005b81811015610a1557600086868381811061079c5761079c61137e565b90506020028101906107ae9190611394565b6040516107bc92919061106b565b60408051918290039091206001600160e01b03198116600090815260c96020529182208054919350906107ee90611279565b80601f016020809104026020016040519081016040528092919081815260200182805461081a90611279565b80156108675780601f1061083c57610100808354040283529160200191610867565b820191906000526020600020905b81548152906001019060200180831161084a57829003601f168201915b505050505090508585848181106108805761088061137e565b905060200201602081019061089591906113db565b80156108a057508051155b15610951578787848181106108b7576108b761137e565b90506020028101906108c99190611394565b6001600160e01b03198416600090815260c9602052604090206108ed929091610f9c565b507f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109215761092161137e565b90506020028101906109339190611394565b6001604051610944939291906113f8565b60405180910390a1610a0b565b8585848181106109635761096361137e565b905060200201602081019061097891906113db565b1580156109855750805115155b15610a0b576001600160e01b03198216600090815260c9602052604081206109ac91611020565b7f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109df576109df61137e565b90506020028101906109f19190611394565b6000604051610a02939291906113f8565b60405180910390a15b5050600101610780565b505050505050565b565b60655433906001600160a01b03168114610a8d5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840161014a565b6104bf81610e73565b610ab760405180606001604052806025815260200161149f60259139610410565b8261ffff16600003610b065760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b610b136105ba8383610e36565b60405163a6c3d16560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063a6c3d16590610b6390869086908690600401611360565b600060405180830381600087803b158015610b7d57600080fd5b505af1158015610b91573d6000803e3d6000fd5b50505050505050565b600054610100900460ff1615808015610bba5750600054600160ff909116105b80610bd45750303b158015610bd4575060005460ff166001145b610c375760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161014a565b6000805460ff191660011790558015610c5a576000805461ff0019166101001790555b610c6382610e8c565b80156104aa576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020015b60405180910390a15050565b610cb5610d1e565b606580546001600160a01b0383166001600160a01b03199091168117909155610ce66033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b03163314610a1d5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161014a565b6001600160a01b038116610ddc5760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b606482015260840161014a565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa09101610ca1565b6000610e42828461141e565b60601c9392505050565b6001600160a01b0381166104bf576040516342bcdf7f60e11b815260040160405180910390fd5b606580546001600160a01b03191690556104bf81610ec4565b600054610100900460ff16610eb35760405162461bcd60e51b815260040161014a90611453565b610ebb610f16565b6104bf81610f45565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff16610f3d5760405162461bcd60e51b815260040161014a90611453565b610a1d610f6c565b600054610100900460ff166104b65760405162461bcd60e51b815260040161014a90611453565b600054610100900460ff16610f935760405162461bcd60e51b815260040161014a90611453565b610a1d33610e73565b828054610fa890611279565b90600052602060002090601f016020900481019282610fca5760008555611010565b82601f10610fe35782800160ff19823516178555611010565b82800160010185558215611010579182015b82811115611010578235825591602001919060010190610ff5565b5061101c929150611056565b5090565b50805461102c90611279565b6000825580601f1061103c575050565b601f0160209004906000526020600020908101906104bf91905b5b8082111561101c5760008155600101611057565b8183823760009101908152919050565b60006020828403121561108d57600080fd5b81356001600160a01b03811681146110a457600080fd5b9392505050565b6000602082840312156110bd57600080fd5b81356001600160e01b0319811681146110a457600080fd5b6000815180845260005b818110156110fb576020818501810151868301820152016110df565b8181111561110d576000602083870101525b50601f01601f19169290920160200192915050565b6020815260006110a460208301846110d5565b60008060006040848603121561114a57600080fd5b833561ffff8116811461115c57600080fd5b9250602084013567ffffffffffffffff8082111561117957600080fd5b818601915086601f83011261118d57600080fd5b81358181111561119c57600080fd5b8760208285010111156111ae57600080fd5b6020830194508093505050509250925092565b60008083601f8401126111d357600080fd5b50813567ffffffffffffffff8111156111eb57600080fd5b6020830191508360208260051b850101111561120657600080fd5b9250929050565b6000806000806040858703121561122357600080fd5b843567ffffffffffffffff8082111561123b57600080fd5b611247888389016111c1565b9096509450602087013591508082111561126057600080fd5b5061126d878288016111c1565b95989497509550505050565b600181811c9082168061128d57607f821691505b6020821081036112ad57634e487b7160e01b600052602260045260246000fd5b50919050565b6001600160a01b0383168152604060208201819052600090610652908301846110d5565b80151581146104bf57600080fd5b6000602082840312156112f757600080fd5b81516110a4816112d7565b6001600160a01b0384811682528316602082015260606040820181905260009061132e908301846110d5565b95945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff8416815260406020820152600061132e604083018486611337565b634e487b7160e01b600052603260045260246000fd5b6000808335601e198436030181126113ab57600080fd5b83018035915067ffffffffffffffff8211156113c657600080fd5b60200191503681900382131561120657600080fd5b6000602082840312156113ed57600080fd5b81356110a4816112d7565b60408152600061140c604083018587611337565b90508215156020830152949350505050565b6bffffffffffffffffffffffff19813581811691601485101561144b5780818660140360031b1b83161692505b505092915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b60608201526080019056fe7365745472757374656452656d6f7465416464726573732875696e7431362c627974657329a2646970667358221220ac99e6bde2c9eb9bdd52a744515930950de54cf45081e77327e35b07ad11a96064736f6c634300080d0033", + "solcInputHash": "15770bc3af16acbd95d8914f14cae6d7", + "metadata": "{\"compiler\":{\"version\":\"0.8.25+commit.b61c2a91\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"XVSBridge_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"sender\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"calledContract\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"methodSignature\",\"type\":\"string\"}],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"string\",\"name\":\"signature\",\"type\":\"string\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"}],\"name\":\"FunctionRegistryChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferStarted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"stateMutability\":\"nonpayable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"XVSBridge\",\"outputs\":[{\"internalType\":\"contract IXVSProxyOFT\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"acceptOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"contract IAccessControlManagerV8\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"name\":\"functionRegistry\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pendingOwner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"remoteAddress_\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner_\",\"type\":\"address\"}],\"name\":\"transferBridgeOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"string[]\",\"name\":\"signatures_\",\"type\":\"string[]\"},{\"internalType\":\"bool[]\",\"name\":\"active_\",\"type\":\"bool[]\"}],\"name\":\"upsertSignature\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"events\":{\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"}},\"kind\":\"dev\",\"methods\":{\"acceptOwnership()\":{\"details\":\"The new owner accepts the ownership transfer.\"},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"initialize(address)\":{\"params\":{\"accessControlManager_\":\"Address of access control manager contract.\"}},\"isTrustedRemote(uint16,bytes)\":{\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"},\"returns\":{\"_0\":\"Bool indicating whether the remote chain is trusted or not.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pendingOwner()\":{\"details\":\"Returns the address of the pending owner.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only Governance\",\"custom:event\":\"Emits NewAccessControlManager event\",\"details\":\"Admin function to set address of AccessControlManager\",\"params\":{\"accessControlManager_\":\"The new address of the AccessControlManager\"}},\"setTrustedRemoteAddress(uint16,bytes)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"custom:error\":\"ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\",\"params\":{\"remoteAddress_\":\"Address of the destination bridge.\",\"remoteChainId_\":\"Chain Id of the destination chain.\"}},\"transferBridgeOwnership(address)\":{\"custom:access\":\"Controlled by AccessControlManager.\",\"params\":{\"newOwner_\":\"New owner of the XVS Bridge.\"}},\"transferOwnership(address)\":{\"details\":\"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.\"},\"upsertSignature(string[],bool[])\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits FunctionRegistryChanged if bool value of function changes.\",\"params\":{\"active_\":\"bool value, should be true to add function.\",\"signatures_\":\"Function signature to be added or removed.\"}}},\"stateVariables\":{\"XVSBridge\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"}},\"title\":\"XVSBridgeAdmin\",\"version\":1},\"userdoc\":{\"errors\":{\"Unauthorized(address,address,string)\":[{\"notice\":\"Thrown when the action is prohibited by AccessControlManager\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"FunctionRegistryChanged(string,bool)\":{\"notice\":\"emitted when function registry updated\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when access control manager contract address is changed\"}},\"kind\":\"user\",\"methods\":{\"accessControlManager()\":{\"notice\":\"Returns the address of the access control manager contract\"},\"functionRegistry(bytes4)\":{\"notice\":\"A mapping keeps track of function signature associated with function name string.\"},\"isTrustedRemote(uint16,bytes)\":{\"notice\":\"Returns true if remote address is trustedRemote corresponds to chainId_.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of AccessControlManager\"},\"setTrustedRemoteAddress(uint16,bytes)\":{\"notice\":\"Sets trusted remote on particular chain.\"},\"transferBridgeOwnership(address)\":{\"notice\":\"This function transfers the ownership of the bridge from this contract to new owner.\"},\"upsertSignature(string[],bool[])\":{\"notice\":\"A setter for the registry of functions that are allowed to be executed from proposals.\"}},\"notice\":\"The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT. It maintains a registry of function signatures and names, allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSBridgeAdmin.sol\":\"XVSBridgeAdmin\"},\"evmVersion\":\"paris\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OwnableUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership} and {acceptOwnership}.\\n *\\n * This module is used through inheritance. It will make available all functions\\n * from parent (Ownable).\\n */\\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\\n function __Ownable2Step_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable2Step_init_unchained() internal onlyInitializing {\\n }\\n address private _pendingOwner;\\n\\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Returns the address of the pending owner.\\n */\\n function pendingOwner() public view virtual returns (address) {\\n return _pendingOwner;\\n }\\n\\n /**\\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual override onlyOwner {\\n _pendingOwner = newOwner;\\n emit OwnershipTransferStarted(owner(), newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual override {\\n delete _pendingOwner;\\n super._transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev The new owner accepts the ownership transfer.\\n */\\n function acceptOwnership() public virtual {\\n address sender = _msgSender();\\n require(pendingOwner() == sender, \\\"Ownable2Step: caller is not the new owner\\\");\\n _transferOwnership(sender);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x84efb8889801b0ac817324aff6acc691d07bbee816b671817132911d287a8c63\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/ContextUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n function __Ownable_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable_init_unchained() internal onlyInitializing {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x4075622496acc77fd6d4de4cc30a8577a744d5c75afad33fdeacf1704d6eda98\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../../utils/AddressUpgradeable.sol\\\";\\n\\n/**\\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\\n *\\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\\n * reused. This mechanism prevents re-execution of each \\\"step\\\" but allows the creation of new initialization steps in\\n * case an upgrade adds a module that needs to be initialized.\\n *\\n * For example:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```solidity\\n * contract MyToken is ERC20Upgradeable {\\n * function initialize() initializer public {\\n * __ERC20_init(\\\"MyToken\\\", \\\"MTK\\\");\\n * }\\n * }\\n *\\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\\n * function initializeV2() reinitializer(2) public {\\n * __ERC20Permit_init(\\\"MyToken\\\");\\n * }\\n * }\\n * ```\\n *\\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\\n *\\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\\n *\\n * [CAUTION]\\n * ====\\n * Avoid leaving a contract uninitialized.\\n *\\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```\\n * /// @custom:oz-upgrades-unsafe-allow constructor\\n * constructor() {\\n * _disableInitializers();\\n * }\\n * ```\\n * ====\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n * @custom:oz-retyped-from bool\\n */\\n uint8 private _initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private _initializing;\\n\\n /**\\n * @dev Triggered when the contract has been initialized or reinitialized.\\n */\\n event Initialized(uint8 version);\\n\\n /**\\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\\n * `onlyInitializing` functions can be used to initialize parent contracts.\\n *\\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\\n * constructor.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier initializer() {\\n bool isTopLevelCall = !_initializing;\\n require(\\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n _initialized = 1;\\n if (isTopLevelCall) {\\n _initializing = true;\\n }\\n _;\\n if (isTopLevelCall) {\\n _initializing = false;\\n emit Initialized(1);\\n }\\n }\\n\\n /**\\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\\n * used to initialize parent contracts.\\n *\\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\\n * are added through upgrades and that require initialization.\\n *\\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\\n * cannot be nested. If one is invoked in the context of another, execution will revert.\\n *\\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\\n * a contract, executing them in the right order is up to the developer or operator.\\n *\\n * WARNING: setting the version to 255 will prevent any future reinitialization.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier reinitializer(uint8 version) {\\n require(!_initializing && _initialized < version, \\\"Initializable: contract is already initialized\\\");\\n _initialized = version;\\n _initializing = true;\\n _;\\n _initializing = false;\\n emit Initialized(version);\\n }\\n\\n /**\\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\\n */\\n modifier onlyInitializing() {\\n require(_initializing, \\\"Initializable: contract is not initializing\\\");\\n _;\\n }\\n\\n /**\\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\\n * through proxies.\\n *\\n * Emits an {Initialized} event the first time it is successfully executed.\\n */\\n function _disableInitializers() internal virtual {\\n require(!_initializing, \\\"Initializable: contract is initializing\\\");\\n if (_initialized != type(uint8).max) {\\n _initialized = type(uint8).max;\\n emit Initialized(type(uint8).max);\\n }\\n }\\n\\n /**\\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\\n */\\n function _getInitializedVersion() internal view returns (uint8) {\\n return _initialized;\\n }\\n\\n /**\\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\\n */\\n function _isInitializing() internal view returns (bool) {\\n return _initializing;\\n }\\n}\\n\",\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary AddressUpgradeable {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract ContextUpgradeable is Initializable {\\n function __Context_init() internal onlyInitializing {\\n }\\n\\n function __Context_init_unchained() internal onlyInitializing {\\n }\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[50] private __gap;\\n}\\n\",\"keccak256\":\"0x963ea7f0b48b032eef72fe3a7582edf78408d6f834115b9feadd673a4d5bd149\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport \\\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\\\";\\nimport \\\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\\\";\\n\\nimport \\\"./IAccessControlManagerV8.sol\\\";\\n\\n/**\\n * @title AccessControlledV8\\n * @author Venus\\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\\n */\\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\\n /// @notice Access control manager contract\\n IAccessControlManagerV8 private _accessControlManager;\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n\\n /// @notice Emitted when access control manager contract address is changed\\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\\n\\n /// @notice Thrown when the action is prohibited by AccessControlManager\\n error Unauthorized(address sender, address calledContract, string methodSignature);\\n\\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\\n __Ownable2Step_init();\\n __AccessControlled_init_unchained(accessControlManager_);\\n }\\n\\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Sets the address of AccessControlManager\\n * @dev Admin function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n * @custom:event Emits NewAccessControlManager event\\n * @custom:access Only Governance\\n */\\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Returns the address of the access control manager contract\\n */\\n function accessControlManager() external view returns (IAccessControlManagerV8) {\\n return _accessControlManager;\\n }\\n\\n /**\\n * @dev Internal function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n */\\n function _setAccessControlManager(address accessControlManager_) internal {\\n require(address(accessControlManager_) != address(0), \\\"invalid acess control manager address\\\");\\n address oldAccessControlManager = address(_accessControlManager);\\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\\n }\\n\\n /**\\n * @notice Reverts if the call is not allowed by AccessControlManager\\n * @param signature Method signature\\n */\\n function _checkAccessAllowed(string memory signature) internal view {\\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\\n\\n if (!isAllowedToCall) {\\n revert Unauthorized(msg.sender, address(this), signature);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x0dcf283925f4dddc23ca0ee71d2cb96a9dd6e4cf08061b69fde1697ea39dc514\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0xaa29b098440d0b3a131c5ecdf25ce548790c1b5ac7bf9b5c0264b6af6f7a1e0b\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Thrown if the supplied value is 0 where it is not allowed\\nerror ZeroValueNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\\n/// @notice Checks if the provided value is nonzero, reverts otherwise\\n/// @param value_ Value to check\\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\\nfunction ensureNonzeroValue(uint256 value_) pure {\\n if (value_ == 0) {\\n revert ZeroValueNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0xdb88e14d50dd21889ca3329d755673d022c47e8da005b6a545c7f69c2c4b7b86\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSBridgeAdmin.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { AccessControlledV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { IXVSProxyOFT } from \\\"./interfaces/IXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSBridgeAdmin\\n * @author Venus\\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\\n * It maintains a registry of function signatures and names,\\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\\n */\\ncontract XVSBridgeAdmin is AccessControlledV8 {\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IXVSProxyOFT public immutable XVSBridge;\\n /**\\n * @notice A mapping keeps track of function signature associated with function name string.\\n */\\n mapping(bytes4 => string) public functionRegistry;\\n\\n /**\\n * @notice emitted when function registry updated\\n */\\n event FunctionRegistryChanged(string signature, bool active);\\n\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(address XVSBridge_) {\\n ensureNonzeroAddress(XVSBridge_);\\n XVSBridge = IXVSProxyOFT(XVSBridge_);\\n _disableInitializers();\\n }\\n\\n /**\\n * @param accessControlManager_ Address of access control manager contract.\\n */\\n function initialize(address accessControlManager_) external initializer {\\n __AccessControlled_init(accessControlManager_);\\n }\\n\\n /**\\n * @notice Invoked when called function does not exist in the contract.\\n * @return Response of low level call.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n fallback(bytes calldata data) external returns (bytes memory) {\\n string memory fun = _getFunctionName(msg.sig);\\n require(bytes(fun).length != 0, \\\"Function not found\\\");\\n _checkAccessAllowed(fun);\\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\\n require(ok, \\\"call failed\\\");\\n return res;\\n }\\n\\n /**\\n * @notice Sets trusted remote on particular chain.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:access Controlled by AccessControlManager.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n */\\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\\n _checkAccessAllowed(\\\"setTrustedRemoteAddress(uint16,bytes)\\\");\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\\n * @param signatures_ Function signature to be added or removed.\\n * @param active_ bool value, should be true to add function.\\n * @custom:access Only owner.\\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\\n */\\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\\n uint256 signatureLength = signatures_.length;\\n require(signatureLength == active_.length, \\\"Input arrays must have the same length\\\");\\n for (uint256 i; i < signatureLength; ) {\\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\\n bytes memory signature = bytes(functionRegistry[sigHash]);\\n if (active_[i] && signature.length == 0) {\\n functionRegistry[sigHash] = signatures_[i];\\n emit FunctionRegistryChanged(signatures_[i], true);\\n } else if (!active_[i] && signature.length != 0) {\\n delete functionRegistry[sigHash];\\n emit FunctionRegistryChanged(signatures_[i], false);\\n }\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /**\\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\\n * @param newOwner_ New owner of the XVS Bridge.\\n * @custom:access Controlled by AccessControlManager.\\n */\\n function transferBridgeOwnership(address newOwner_) external {\\n _checkAccessAllowed(\\\"transferBridgeOwnership(address)\\\");\\n XVSBridge.transferOwnership(newOwner_);\\n }\\n\\n /**\\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\\n * @param remoteChainId_ Chain Id of the destination chain.\\n * @param remoteAddress_ Address of the destination bridge.\\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\\n * @return Bool indicating whether the remote chain is trusted or not.\\n */\\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\\n require(remoteChainId_ != 0, \\\"ChainId must not be zero\\\");\\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @dev Returns function name string associated with function signature.\\n * @param signature_ Four bytes of function signature.\\n * @return Function signature corresponding to its hash.\\n */\\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\\n return functionRegistry[signature_];\\n }\\n\\n /**\\n * @notice Converts given bytes into address.\\n * @param b Bytes to be converted into address.\\n * @return Converted address of given bytes.\\n */\\n function bytesToAddress(bytes calldata b) private pure returns (address) {\\n return address(uint160(bytes20(b)));\\n }\\n}\\n\",\"keccak256\":\"0x7a353b13a255e1bc73a8f482a8fc4ae1c5785400bf4795cb12eee4a2cb7fbb45\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\n/**\\n * @title IXVSProxyOFT\\n * @author Venus\\n * @notice Interface implemented by `XVSProxyOFT`.\\n */\\ninterface IXVSProxyOFT {\\n function transferOwnership(address addr) external;\\n\\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\\n\\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\\n}\\n\",\"keccak256\":\"0xe72963d6cb0c35c473dbc43d5c761a8814015fc0f25c1d4490ef3273d5ed40b1\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x60a060405234801561001057600080fd5b5060405161173838038061173883398101604081905261002f9161013c565b61003881610053565b6001600160a01b03811660805261004d61007d565b5061016c565b6001600160a01b03811661007a576040516342bcdf7f60e11b815260040160405180910390fd5b50565b600054610100900460ff16156100e95760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161461013a576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b60006020828403121561014e57600080fd5b81516001600160a01b038116811461016557600080fd5b9392505050565b6080516115956101a3600039600081816101610152818161026c015281816105d6015281816106b70152610b2b01526115956000f3fe608060405234801561001057600080fd5b50600436106100ea5760003560e01c806379ba50971161008c578063b4a0bdf311610066578063b4a0bdf31461031b578063c4d66de81461032c578063e30c39781461033f578063f2fde38b14610350576100ea565b806379ba5097146102ef5780638da5cb5b146102f7578063a6c3d16514610308576100ea565b80633d8b38f6116100c85780633d8b38f6146102a65780633f90b540146102c95780634bb7453e146102dc578063715018a61461023c576100ea565b80630e32cb8614610229578063180d295c1461023e57806327a020ef14610267575b600036606060006101066000356001600160e01b031916610363565b905080516000036101535760405162461bcd60e51b8152602060048201526012602482015271119d5b98dd1a5bdb881b9bdd08199bdd5b9960721b60448201526064015b60405180910390fd5b61015c81610410565b6000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168686604051610199929190610feb565b6000604051808303816000865af19150503d80600081146101d6576040519150601f19603f3d011682016040523d82523d6000602084013e6101db565b606091505b50915091508161021b5760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161014a565b805195506020019350505050f35b61023c610237366004610ffb565b6104ae565b005b61025161024c36600461102b565b6104c2565b60405161025e919061109b565b60405180910390f35b61028e7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161025e565b6102b96102b43660046110ae565b61055c565b604051901515815260200161025e565b61023c6102d7366004610ffb565b61065a565b61023c6102ea366004611186565b610716565b61023c610a20565b6033546001600160a01b031661028e565b61023c6103163660046110ae565b610a97565b6097546001600160a01b031661028e565b61023c61033a366004610ffb565b610b9b565b6065546001600160a01b031661028e565b61023c61035e366004610ffb565b610cae565b6001600160e01b03198116600090815260c96020526040902080546060919061038b906111f2565b80601f01602080910402602001604051908101604052809291908181526020018280546103b7906111f2565b80156104045780601f106103d957610100808354040283529160200191610404565b820191906000526020600020905b8154815290600101906020018083116103e757829003601f168201915b50505050509050919050565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab90610443903390869060040161122c565b602060405180830381865afa158015610460573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610484919061125e565b9050806104aa57333083604051634a3fa29360e01b815260040161014a9392919061127b565b5050565b6104b6610d1f565b6104bf81610d79565b50565b60c960205260009081526040902080546104db906111f2565b80601f0160208091040260200160405190810160405280929190818152602001828054610507906111f2565b80156105545780601f1061052957610100808354040283529160200191610554565b820191906000526020600020905b81548152906001019060200180831161053757829003601f168201915b505050505081565b60008361ffff166000036105ad5760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b6105bf6105ba8484610e37565b610e4d565b604051631ec59c7b60e11b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633d8b38f69061060f908790879087906004016112d9565b6020604051808303816000875af115801561062e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610652919061125e565b949350505050565b6106986040518060400160405280602081526020017f7472616e736665724272696467654f776e657273686970286164647265737329815250610410565b60405163f2fde38b60e01b81526001600160a01b0382811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063f2fde38b90602401600060405180830381600087803b1580156106fb57600080fd5b505af115801561070f573d6000803e3d6000fd5b5050505050565b61071e610d1f565b8281811461077d5760405162461bcd60e51b815260206004820152602660248201527f496e70757420617272617973206d7573742068617665207468652073616d65206044820152650d8cadccee8d60d31b606482015260840161014a565b60005b81811015610a1657600086868381811061079c5761079c6112f7565b90506020028101906107ae919061130d565b6040516107bc929190610feb565b60408051918290039091206001600160e01b03198116600090815260c96020529182208054919350906107ee906111f2565b80601f016020809104026020016040519081016040528092919081815260200182805461081a906111f2565b80156108675780601f1061083c57610100808354040283529160200191610867565b820191906000526020600020905b81548152906001019060200180831161084a57829003601f168201915b50505050509050858584818110610880576108806112f7565b90506020020160208101906108959190611354565b80156108a057508051155b15610952578787848181106108b7576108b76112f7565b90506020028101906108c9919061130d565b6001600160e01b03198416600090815260c960205260409020916108ee9190836113d4565b507f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa888885818110610922576109226112f7565b9050602002810190610934919061130d565b600160405161094593929190611494565b60405180910390a1610a0c565b858584818110610964576109646112f7565b90506020020160208101906109799190611354565b1580156109865750805115155b15610a0c576001600160e01b03198216600090815260c9602052604081206109ad91610f9d565b7f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109e0576109e06112f7565b90506020028101906109f2919061130d565b6000604051610a0393929190611494565b60405180910390a15b5050600101610780565b505050505050565b565b60655433906001600160a01b03168114610a8e5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840161014a565b6104bf81610e74565b610ab860405180606001604052806025815260200161153b60259139610410565b8261ffff16600003610b075760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b610b146105ba8383610e37565b60405163a6c3d16560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063a6c3d16590610b64908690869086906004016112d9565b600060405180830381600087803b158015610b7e57600080fd5b505af1158015610b92573d6000803e3d6000fd5b50505050505050565b600054610100900460ff1615808015610bbb5750600054600160ff909116105b80610bd55750303b158015610bd5575060005460ff166001145b610c385760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161014a565b6000805460ff191660011790558015610c5b576000805461ff0019166101001790555b610c6482610e8d565b80156104aa576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020015b60405180910390a15050565b610cb6610d1f565b606580546001600160a01b0383166001600160a01b03199091168117909155610ce76033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b03163314610a1e5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161014a565b6001600160a01b038116610ddd5760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b606482015260840161014a565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa09101610ca2565b6000610e4382846114ba565b60601c9392505050565b6001600160a01b0381166104bf576040516342bcdf7f60e11b815260040160405180910390fd5b606580546001600160a01b03191690556104bf81610ec5565b600054610100900460ff16610eb45760405162461bcd60e51b815260040161014a906114ef565b610ebc610f17565b6104bf81610f46565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff16610f3e5760405162461bcd60e51b815260040161014a906114ef565b610a1e610f6d565b600054610100900460ff166104b65760405162461bcd60e51b815260040161014a906114ef565b600054610100900460ff16610f945760405162461bcd60e51b815260040161014a906114ef565b610a1e33610e74565b508054610fa9906111f2565b6000825580601f10610fb9575050565b601f0160209004906000526020600020908101906104bf91905b80821115610fe75760008155600101610fd3565b5090565b8183823760009101908152919050565b60006020828403121561100d57600080fd5b81356001600160a01b038116811461102457600080fd5b9392505050565b60006020828403121561103d57600080fd5b81356001600160e01b03198116811461102457600080fd5b6000815180845260005b8181101561107b5760208185018101518683018201520161105f565b506000602082860101526020601f19601f83011685010191505092915050565b6020815260006110246020830184611055565b6000806000604084860312156110c357600080fd5b833561ffff811681146110d557600080fd5b9250602084013567ffffffffffffffff808211156110f257600080fd5b818601915086601f83011261110657600080fd5b81358181111561111557600080fd5b87602082850101111561112757600080fd5b6020830194508093505050509250925092565b60008083601f84011261114c57600080fd5b50813567ffffffffffffffff81111561116457600080fd5b6020830191508360208260051b850101111561117f57600080fd5b9250929050565b6000806000806040858703121561119c57600080fd5b843567ffffffffffffffff808211156111b457600080fd5b6111c08883890161113a565b909650945060208701359150808211156111d957600080fd5b506111e68782880161113a565b95989497509550505050565b600181811c9082168061120657607f821691505b60208210810361122657634e487b7160e01b600052602260045260246000fd5b50919050565b6001600160a01b038316815260406020820181905260009061065290830184611055565b80151581146104bf57600080fd5b60006020828403121561127057600080fd5b815161102481611250565b6001600160a01b038481168252831660208201526060604082018190526000906112a790830184611055565b95945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff841681526040602082015260006112a76040830184866112b0565b634e487b7160e01b600052603260045260246000fd5b6000808335601e1984360301811261132457600080fd5b83018035915067ffffffffffffffff82111561133f57600080fd5b60200191503681900382131561117f57600080fd5b60006020828403121561136657600080fd5b813561102481611250565b634e487b7160e01b600052604160045260246000fd5b601f8211156113cf576000816000526020600020601f850160051c810160208610156113b05750805b601f850160051c820191505b81811015610a16578281556001016113bc565b505050565b67ffffffffffffffff8311156113ec576113ec611371565b611400836113fa83546111f2565b83611387565b6000601f841160018114611434576000851561141c5750838201355b600019600387901b1c1916600186901b17835561070f565b600083815260209020601f19861690835b828110156114655786850135825560209485019460019092019101611445565b50868210156114825760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b6040815260006114a86040830185876112b0565b90508215156020830152949350505050565b6bffffffffffffffffffffffff1981358181169160148510156114e75780818660140360031b1b83161692505b505092915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b60608201526080019056fe7365745472757374656452656d6f7465416464726573732875696e7431362c627974657329a264697066735822122071305fbafcd92775815df4985c46a13c15aabb4d1b88605c4f0e967df9f657df64736f6c63430008190033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100ea5760003560e01c806379ba50971161008c578063b4a0bdf311610066578063b4a0bdf31461031b578063c4d66de81461032c578063e30c39781461033f578063f2fde38b14610350576100ea565b806379ba5097146102ef5780638da5cb5b146102f7578063a6c3d16514610308576100ea565b80633d8b38f6116100c85780633d8b38f6146102a65780633f90b540146102c95780634bb7453e146102dc578063715018a61461023c576100ea565b80630e32cb8614610229578063180d295c1461023e57806327a020ef14610267575b600036606060006101066000356001600160e01b031916610363565b905080516000036101535760405162461bcd60e51b8152602060048201526012602482015271119d5b98dd1a5bdb881b9bdd08199bdd5b9960721b60448201526064015b60405180910390fd5b61015c81610410565b6000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168686604051610199929190610feb565b6000604051808303816000865af19150503d80600081146101d6576040519150601f19603f3d011682016040523d82523d6000602084013e6101db565b606091505b50915091508161021b5760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161014a565b805195506020019350505050f35b61023c610237366004610ffb565b6104ae565b005b61025161024c36600461102b565b6104c2565b60405161025e919061109b565b60405180910390f35b61028e7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161025e565b6102b96102b43660046110ae565b61055c565b604051901515815260200161025e565b61023c6102d7366004610ffb565b61065a565b61023c6102ea366004611186565b610716565b61023c610a20565b6033546001600160a01b031661028e565b61023c6103163660046110ae565b610a97565b6097546001600160a01b031661028e565b61023c61033a366004610ffb565b610b9b565b6065546001600160a01b031661028e565b61023c61035e366004610ffb565b610cae565b6001600160e01b03198116600090815260c96020526040902080546060919061038b906111f2565b80601f01602080910402602001604051908101604052809291908181526020018280546103b7906111f2565b80156104045780601f106103d957610100808354040283529160200191610404565b820191906000526020600020905b8154815290600101906020018083116103e757829003601f168201915b50505050509050919050565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab90610443903390869060040161122c565b602060405180830381865afa158015610460573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610484919061125e565b9050806104aa57333083604051634a3fa29360e01b815260040161014a9392919061127b565b5050565b6104b6610d1f565b6104bf81610d79565b50565b60c960205260009081526040902080546104db906111f2565b80601f0160208091040260200160405190810160405280929190818152602001828054610507906111f2565b80156105545780601f1061052957610100808354040283529160200191610554565b820191906000526020600020905b81548152906001019060200180831161053757829003601f168201915b505050505081565b60008361ffff166000036105ad5760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b6105bf6105ba8484610e37565b610e4d565b604051631ec59c7b60e11b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633d8b38f69061060f908790879087906004016112d9565b6020604051808303816000875af115801561062e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610652919061125e565b949350505050565b6106986040518060400160405280602081526020017f7472616e736665724272696467654f776e657273686970286164647265737329815250610410565b60405163f2fde38b60e01b81526001600160a01b0382811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063f2fde38b90602401600060405180830381600087803b1580156106fb57600080fd5b505af115801561070f573d6000803e3d6000fd5b5050505050565b61071e610d1f565b8281811461077d5760405162461bcd60e51b815260206004820152602660248201527f496e70757420617272617973206d7573742068617665207468652073616d65206044820152650d8cadccee8d60d31b606482015260840161014a565b60005b81811015610a1657600086868381811061079c5761079c6112f7565b90506020028101906107ae919061130d565b6040516107bc929190610feb565b60408051918290039091206001600160e01b03198116600090815260c96020529182208054919350906107ee906111f2565b80601f016020809104026020016040519081016040528092919081815260200182805461081a906111f2565b80156108675780601f1061083c57610100808354040283529160200191610867565b820191906000526020600020905b81548152906001019060200180831161084a57829003601f168201915b50505050509050858584818110610880576108806112f7565b90506020020160208101906108959190611354565b80156108a057508051155b15610952578787848181106108b7576108b76112f7565b90506020028101906108c9919061130d565b6001600160e01b03198416600090815260c960205260409020916108ee9190836113d4565b507f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa888885818110610922576109226112f7565b9050602002810190610934919061130d565b600160405161094593929190611494565b60405180910390a1610a0c565b858584818110610964576109646112f7565b90506020020160208101906109799190611354565b1580156109865750805115155b15610a0c576001600160e01b03198216600090815260c9602052604081206109ad91610f9d565b7f9d424e54f4d851aabd288f6cc4946e5726d6b5c0e66ea4ef159a3c40bcc470fa8888858181106109e0576109e06112f7565b90506020028101906109f2919061130d565b6000604051610a0393929190611494565b60405180910390a15b5050600101610780565b505050505050565b565b60655433906001600160a01b03168114610a8e5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840161014a565b6104bf81610e74565b610ab860405180606001604052806025815260200161153b60259139610410565b8261ffff16600003610b075760405162461bcd60e51b8152602060048201526018602482015277436861696e4964206d757374206e6f74206265207a65726f60401b604482015260640161014a565b610b146105ba8383610e37565b60405163a6c3d16560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063a6c3d16590610b64908690869086906004016112d9565b600060405180830381600087803b158015610b7e57600080fd5b505af1158015610b92573d6000803e3d6000fd5b50505050505050565b600054610100900460ff1615808015610bbb5750600054600160ff909116105b80610bd55750303b158015610bd5575060005460ff166001145b610c385760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161014a565b6000805460ff191660011790558015610c5b576000805461ff0019166101001790555b610c6482610e8d565b80156104aa576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020015b60405180910390a15050565b610cb6610d1f565b606580546001600160a01b0383166001600160a01b03199091168117909155610ce76033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b03163314610a1e5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161014a565b6001600160a01b038116610ddd5760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b606482015260840161014a565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa09101610ca2565b6000610e4382846114ba565b60601c9392505050565b6001600160a01b0381166104bf576040516342bcdf7f60e11b815260040160405180910390fd5b606580546001600160a01b03191690556104bf81610ec5565b600054610100900460ff16610eb45760405162461bcd60e51b815260040161014a906114ef565b610ebc610f17565b6104bf81610f46565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff16610f3e5760405162461bcd60e51b815260040161014a906114ef565b610a1e610f6d565b600054610100900460ff166104b65760405162461bcd60e51b815260040161014a906114ef565b600054610100900460ff16610f945760405162461bcd60e51b815260040161014a906114ef565b610a1e33610e74565b508054610fa9906111f2565b6000825580601f10610fb9575050565b601f0160209004906000526020600020908101906104bf91905b80821115610fe75760008155600101610fd3565b5090565b8183823760009101908152919050565b60006020828403121561100d57600080fd5b81356001600160a01b038116811461102457600080fd5b9392505050565b60006020828403121561103d57600080fd5b81356001600160e01b03198116811461102457600080fd5b6000815180845260005b8181101561107b5760208185018101518683018201520161105f565b506000602082860101526020601f19601f83011685010191505092915050565b6020815260006110246020830184611055565b6000806000604084860312156110c357600080fd5b833561ffff811681146110d557600080fd5b9250602084013567ffffffffffffffff808211156110f257600080fd5b818601915086601f83011261110657600080fd5b81358181111561111557600080fd5b87602082850101111561112757600080fd5b6020830194508093505050509250925092565b60008083601f84011261114c57600080fd5b50813567ffffffffffffffff81111561116457600080fd5b6020830191508360208260051b850101111561117f57600080fd5b9250929050565b6000806000806040858703121561119c57600080fd5b843567ffffffffffffffff808211156111b457600080fd5b6111c08883890161113a565b909650945060208701359150808211156111d957600080fd5b506111e68782880161113a565b95989497509550505050565b600181811c9082168061120657607f821691505b60208210810361122657634e487b7160e01b600052602260045260246000fd5b50919050565b6001600160a01b038316815260406020820181905260009061065290830184611055565b80151581146104bf57600080fd5b60006020828403121561127057600080fd5b815161102481611250565b6001600160a01b038481168252831660208201526060604082018190526000906112a790830184611055565b95945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff841681526040602082015260006112a76040830184866112b0565b634e487b7160e01b600052603260045260246000fd5b6000808335601e1984360301811261132457600080fd5b83018035915067ffffffffffffffff82111561133f57600080fd5b60200191503681900382131561117f57600080fd5b60006020828403121561136657600080fd5b813561102481611250565b634e487b7160e01b600052604160045260246000fd5b601f8211156113cf576000816000526020600020601f850160051c810160208610156113b05750805b601f850160051c820191505b81811015610a16578281556001016113bc565b505050565b67ffffffffffffffff8311156113ec576113ec611371565b611400836113fa83546111f2565b83611387565b6000601f841160018114611434576000851561141c5750838201355b600019600387901b1c1916600186901b17835561070f565b600083815260209020601f19861690835b828110156114655786850135825560209485019460019092019101611445565b50868210156114825760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b6040815260006114a86040830185876112b0565b90508215156020830152949350505050565b6bffffffffffffffffffffffff1981358181169160148510156114e75780818660140360031b1b83161692505b505092915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b60608201526080019056fe7365745472757374656452656d6f7465416464726573732875696e7431362c627974657329a264697066735822122071305fbafcd92775815df4985c46a13c15aabb4d1b88605c4f0e967df9f657df64736f6c63430008190033", "devdoc": { "author": "Venus", + "events": { + "Initialized(uint8)": { + "details": "Triggered when the contract has been initialized or reinitialized." + } + }, "kind": "dev", "methods": { "acceptOwnership()": { @@ -489,7 +494,7 @@ "storageLayout": { "storage": [ { - "astId": 4452, + "astId": 2909, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "_initialized", "offset": 0, @@ -497,7 +502,7 @@ "type": "t_uint8" }, { - "astId": 4455, + "astId": 2912, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "_initializing", "offset": 1, @@ -505,7 +510,7 @@ "type": "t_bool" }, { - "astId": 4985, + "astId": 3442, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "__gap", "offset": 0, @@ -513,7 +518,7 @@ "type": "t_array(t_uint256)50_storage" }, { - "astId": 4324, + "astId": 2781, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "_owner", "offset": 0, @@ -521,7 +526,7 @@ "type": "t_address" }, { - "astId": 4444, + "astId": 2901, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "__gap", "offset": 0, @@ -529,7 +534,7 @@ "type": "t_array(t_uint256)49_storage" }, { - "astId": 4233, + "astId": 2690, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "_pendingOwner", "offset": 0, @@ -537,7 +542,7 @@ "type": "t_address" }, { - "astId": 4312, + "astId": 2769, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "__gap", "offset": 0, @@ -545,15 +550,15 @@ "type": "t_array(t_uint256)49_storage" }, { - "astId": 8479, + "astId": 4629, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "_accessControlManager", "offset": 0, "slot": "151", - "type": "t_contract(IAccessControlManagerV8)8664" + "type": "t_contract(IAccessControlManagerV8)4814" }, { - "astId": 8484, + "astId": 4634, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "__gap", "offset": 0, @@ -561,7 +566,7 @@ "type": "t_array(t_uint256)49_storage" }, { - "astId": 10420, + "astId": 6592, "contract": "contracts/Bridge/XVSBridgeAdmin.sol:XVSBridgeAdmin", "label": "functionRegistry", "offset": 0, @@ -597,7 +602,7 @@ "label": "bytes4", "numberOfBytes": "4" }, - "t_contract(IAccessControlManagerV8)8664": { + "t_contract(IAccessControlManagerV8)4814": { "encoding": "inplace", "label": "contract IAccessControlManagerV8", "numberOfBytes": "20" diff --git a/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json b/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json index d9c4842..cb7953c 100644 --- a/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json +++ b/deployments/arbitrumsepolia/XVSBridgeAdmin_Proxy.json @@ -1,5 +1,5 @@ { - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "abi": [ { "inputs": [ @@ -146,82 +146,82 @@ "type": "receive" } ], - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "contractAddress": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "transactionIndex": 2, - "gasUsed": "1679305", - "logsBloom": "0x00000000000000000000000200000040400020000000000400800000000000040000000000000000000000000000000000000000000000000000000000008000000000000000004000000000000002000001000000000000000000000000000000000000020000040000000000000800000000800000000000000000000000400000000000000000000000000000000000000000000080000000000000800000000000000000000000000001000400000000000000800000000000000000000000000020000000000000000000040000000000000400000000000000000020000200000000000000000000000000000000000800000000000000000000000000", - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32", - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", + "gasUsed": "796839", + "logsBloom": "0x00000000000000000000000200000000400000000000000400800000000000040000000000000020000000000000010000000000000000000000000000008100000000000000000000000000000002000001000000000000000000000000000000000000020000000000000000000800000000800000000000000000000000400000000000000000020000000000000000000000000080000000000000800000000000000000000000000000000400000000000000800000000000000000000000000020000000000000000000040000000000000400000000000000000020000000000000000000000000000000000000000800000000400000000001000000", + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41", + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", "logs": [ { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": [ "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", - "0x000000000000000000000000d2048bd9e1d9a515cc57e270d0928b1127348ae1" + "0x0000000000000000000000003514fb2bbaf4d749af5908311b4c1867beb349cb" ], "data": "0x", - "logIndex": 4, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 1, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 5, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 2, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": ["0x66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f", - "logIndex": 6, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 3, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], "data": "0x0000000000000000000000000000000000000000000000000000000000000001", - "logIndex": 7, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 4, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" }, { "transactionIndex": 2, - "blockNumber": 27132301, - "transactionHash": "0xb63f1d8df57502b4f58552865096a179a74b158ede50c27deff17a6fcb6adb17", - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "blockNumber": 36234810, + "transactionHash": "0x9a6dd34ffe5012028fb3d0b00d4629f535ce47e7e22efa422061bb58cd35c57d", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a78a1df376c3ceebc5fab574fe6eddbbf76fd03e", - "logIndex": 8, - "blockHash": "0xd4fb8336770134ab82a80135f27f86255bfeed6ca616c6c7b8a38a25819d8a32" + "logIndex": 5, + "blockHash": "0xc7e0dfe3107e808507d63110a4b12e2408e7d0df4278fec1fbba0ba5e0d09c41" } ], - "blockNumber": 27132301, - "cumulativeGasUsed": "3399219", + "blockNumber": 36234810, + "cumulativeGasUsed": "823530", "status": 1, "byzantium": true }, "args": [ - "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", "0xc4d66de8000000000000000000000000a36ad96441cb931d8dfeaaac97d3fab4b39e590f" ], diff --git a/deployments/arbitrumsepolia/XVSProxyOFTDest.json b/deployments/arbitrumsepolia/XVSProxyOFTDest.json index eaeacb0..c1065e4 100644 --- a/deployments/arbitrumsepolia/XVSProxyOFTDest.json +++ b/deployments/arbitrumsepolia/XVSProxyOFTDest.json @@ -1,5 +1,5 @@ { - "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", + "address": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4", "abi": [ { "inputs": [ @@ -1891,77 +1891,91 @@ "type": "function" } ], - "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", + "transactionHash": "0x2030a4a82692364c0fa775792e6df52ac3747b0a5c6b732f922f581d968939bd", "receipt": { "to": null, "from": "0x638Eb8DFfF094Fd1d52c5A198b44984806C521E5", - "contractAddress": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", - "transactionIndex": 3, - "gasUsed": "9090719", - "logsBloom": "0x00000000000000000000000200000000000000000000000400800000000000040000000000000000000000000000000008000000000000000000200000000000000000000000000000080000000000000001000020000000000000000000000000000000020000000000000000000800000000000000000000000000800000400000000000000000000000000000000000000000100000000000000000000080400000000000000000080000100000000000002010000000040000000000000000000000000000000000000000000000000000000200000000000000000020000000000000000000000000400000000000000000000000000000000000000000", - "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed", - "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", + "contractAddress": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4", + "transactionIndex": 1, + "gasUsed": "4834652", + "logsBloom": "0x00000000000080000000000200000000000000000000004400800000000000040000000000000000000000000000000008000000000000000000200040000800000000000000000000080000000000000001000020000000000000000000000002000000020000000000000000000800000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080400000000000000000000000100000000000000010000000040008000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0xa0508fe3d67ef2e809aebf91e112555e923f00e94cf0408215aaa81aa9a21b11", + "transactionHash": "0x2030a4a82692364c0fa775792e6df52ac3747b0a5c6b732f922f581d968939bd", "logs": [ { - "transactionIndex": 3, - "blockNumber": 27132260, - "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", - "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", + "transactionIndex": 1, + "blockNumber": 36234780, + "transactionHash": "0x2030a4a82692364c0fa775792e6df52ac3747b0a5c6b732f922f581d968939bd", + "address": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4", "topics": [ "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x000000000000000000000000638eb8dfff094fd1d52c5a198b44984806c521e5" ], "data": "0x", - "logIndex": 20, - "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed" + "logIndex": 0, + "blockHash": "0xa0508fe3d67ef2e809aebf91e112555e923f00e94cf0408215aaa81aa9a21b11" }, { - "transactionIndex": 3, - "blockNumber": 27132260, - "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", - "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", + "transactionIndex": 1, + "blockNumber": 36234780, + "transactionHash": "0x2030a4a82692364c0fa775792e6df52ac3747b0a5c6b732f922f581d968939bd", + "address": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4", "topics": [ "0x0b673f021ff9a27bbe58f282908695869e130b3103029190387b83650806c2c3", - "0x00000000000000000000000047fa6e9f717c9eb081c4734ffb5a1ecd70508891" + "0x000000000000000000000000877dc896e7b13096d3827872e396927bbe704407" ], "data": "0x", - "logIndex": 21, - "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed" + "logIndex": 1, + "blockHash": "0xa0508fe3d67ef2e809aebf91e112555e923f00e94cf0408215aaa81aa9a21b11" }, { - "transactionIndex": 3, - "blockNumber": 27132260, - "transactionHash": "0x2c8ea2c43da6fbfc9ceb99680d2e3ab9ceae078c07ac66c19d98e3575c2431ea", - "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", + "transactionIndex": 1, + "blockNumber": 36234780, + "transactionHash": "0x2030a4a82692364c0fa775792e6df52ac3747b0a5c6b732f922f581d968939bd", + "address": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4", "topics": [ "0x05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000006708bad042916b47311c8078b29d7f432342102f" ], "data": "0x", - "logIndex": 22, - "blockHash": "0xd1e95873b5672aabc7655eeac7b98236263e78e84239aaef04b75a308c71efed" + "logIndex": 2, + "blockHash": "0xa0508fe3d67ef2e809aebf91e112555e923f00e94cf0408215aaa81aa9a21b11" } ], - "blockNumber": 27132260, - "cumulativeGasUsed": "10502621", + "blockNumber": 36234780, + "cumulativeGasUsed": "4834652", "status": 1, "byzantium": true }, "args": [ - "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "0x877Dc896e7b13096D3827872e396927BbE704407", 8, "0x6098e96a28E02f27B1e6BD381f870F1C8Bd169d3", "0x6708bAd042916B47311c8078b29d7f432342102F" ], "numDeployments": 1, - "solcInputHash": "f2046c3ab03975d1be43bca1cf657398", - "metadata": "{\"compiler\":{\"version\":\"0.8.13+commit.abaa5c0e\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress_\",\"type\":\"address\"},{\"internalType\":\"uint8\",\"name\":\"sharedDecimals_\",\"type\":\"uint8\"},{\"internalType\":\"address\",\"name\":\"lzEndpoint_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"oracle_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"sweepAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"name\":\"InsufficientBalance\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"_hash\",\"type\":\"bytes32\"}],\"name\":\"CallOFTReceivedSuccess\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"srcChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"bytes\",\"name\":\"srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"nonce\",\"type\":\"uint64\"}],\"name\":\"DropFailedMessage\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"innerToken\",\"type\":\"address\"}],\"name\":\"InnerTokenAdded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_reason\",\"type\":\"bytes\"}],\"name\":\"MessageFailed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"NonContractAddress\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldOracle\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOracle\",\"type\":\"address\"}],\"name\":\"OracleChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"ReceiveFromChain\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"_payloadHash\",\"type\":\"bytes32\"}],\"name\":\"RetryMessageSuccess\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"SendToChain\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxDailyLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxDailyReceiveLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxSingleReceiveTransactionLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxSingleTransactionLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_type\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_minDstGas\",\"type\":\"uint256\"}],\"name\":\"SetMinDstGas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"precrime\",\"type\":\"address\"}],\"name\":\"SetPrecrime\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_path\",\"type\":\"bytes\"}],\"name\":\"SetTrustedRemote\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_remoteAddress\",\"type\":\"bytes\"}],\"name\":\"SetTrustedRemoteAddress\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"addr\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isWhitelist\",\"type\":\"bool\"}],\"name\":\"SetWhitelist\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"sweepAmount\",\"type\":\"uint256\"}],\"name\":\"SweepToken\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"}],\"name\":\"TrustedRemoteRemoved\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"UpdateSendAndCallEnabled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"DEFAULT_PAYLOAD_SIZE_LIMIT\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"NO_EXTRA_GAS\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"PT_SEND\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"PT_SEND_AND_CALL\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes32\",\"name\":\"_from\",\"type\":\"bytes32\"},{\"internalType\":\"address\",\"name\":\"_to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"_gasForCall\",\"type\":\"uint256\"}],\"name\":\"callOnOFTReceived\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourReceiveWindowStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourReceived\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourTransferred\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourWindowStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxDailyLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxDailyReceiveLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxSingleReceiveTransactionLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxSingleTransactionLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"circulatingSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"creditedPackets\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"srcChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"srcAddress_\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"nonce_\",\"type\":\"uint64\"}],\"name\":\"dropFailedMessage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_dstGasForCall\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"_useZro\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"_adapterParams\",\"type\":\"bytes\"}],\"name\":\"estimateSendAndCallFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"nativeFee\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"zroFee\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"_useZro\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"_adapterParams\",\"type\":\"bytes\"}],\"name\":\"estimateSendFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"nativeFee\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"zroFee\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"failedMessages\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"}],\"name\":\"forceResumeReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_chainId\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_configType\",\"type\":\"uint256\"}],\"name\":\"getConfig\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"}],\"name\":\"getTrustedRemoteAddress\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from_\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"dstChainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"isEligibleToSend\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"eligibleToSend\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"maxSingleTransactionLimit\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"maxDailyLimit\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"amountInUsd\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"transferredInWindow\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"last24HourWindowStart\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"isWhiteListedUser\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"lzEndpoint\",\"outputs\":[{\"internalType\":\"contract ILayerZeroEndpoint\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"lzReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"minDstGasLookup\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"nonblockingLzReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"oracle\",\"outputs\":[{\"internalType\":\"contract ResilientOracleInterface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"payloadSizeLimitLookup\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"precrime\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"}],\"name\":\"removeTrustedRemote\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"retryMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from_\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"dstChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"toAddress_\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"payload_\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"dstGasForCall_\",\"type\":\"uint64\"},{\"components\":[{\"internalType\":\"address payable\",\"name\":\"refundAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"zroPaymentAddress\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"adapterParams\",\"type\":\"bytes\"}],\"internalType\":\"struct ICommonOFT.LzCallParams\",\"name\":\"callparams_\",\"type\":\"tuple\"}],\"name\":\"sendAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"sendAndCallEnabled\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_from\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"address payable\",\"name\":\"refundAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"zroPaymentAddress\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"adapterParams\",\"type\":\"bytes\"}],\"internalType\":\"struct ICommonOFT.LzCallParams\",\"name\":\"_callParams\",\"type\":\"tuple\"}],\"name\":\"sendFrom\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_chainId\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_configType\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_config\",\"type\":\"bytes\"}],\"name\":\"setConfig\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxDailyLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxDailyReceiveLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxSingleReceiveTransactionLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxSingleTransactionLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_packetType\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_minGas\",\"type\":\"uint256\"}],\"name\":\"setMinDstGas\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"oracleAddress_\",\"type\":\"address\"}],\"name\":\"setOracle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_size\",\"type\":\"uint256\"}],\"name\":\"setPayloadSizeLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_precrime\",\"type\":\"address\"}],\"name\":\"setPrecrime\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"}],\"name\":\"setReceiveVersion\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"}],\"name\":\"setSendVersion\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_path\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemote\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_remoteAddress\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"val_\",\"type\":\"bool\"}],\"name\":\"setWhitelist\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"sharedDecimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"interfaceId\",\"type\":\"bytes4\"}],\"name\":\"supportsInterface\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"token_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"sweepToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"token\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"trustedRemoteLookup\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"unpause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"enabled_\",\"type\":\"bool\"}],\"name\":\"updateSendAndCallEnabled\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"whitelist\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"kind\":\"dev\",\"methods\":{\"circulatingSupply()\":{\"returns\":{\"_0\":\"total circulating supply of the token on the destination chain.\"}},\"dropFailedMessage(uint16,bytes,uint64)\":{\"custom:access\":\"Only owner\",\"custom:event\":\"Emits DropFailedMessage on clearance of failed message.\",\"params\":{\"nonce_\":\"Nonce_ of the transaction\",\"srcAddress_\":\"Address of source followed by current bridge address\",\"srcChainId_\":\"Chain id of source\"}},\"estimateSendFee(uint16,bytes32,uint256,bool,bytes)\":{\"details\":\"estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`) _dstChainId - L0 defined chain id to send tokens too _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain _amount - amount of the tokens to transfer _useZro - indicates to use zro to pay L0 fees _adapterParam - flexible bytes array to indicate messaging adapter services in L0\"},\"isEligibleToSend(address,uint16,uint256)\":{\"details\":\"This external view function assesses whether the specified sender is eligible to transfer the given amount to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\",\"params\":{\"amount_\":\"The quantity of tokens to be transferred.\",\"dstChainId_\":\"Indicates destination chain.\",\"from_\":\"The sender's address initiating the transfer.\"},\"returns\":{\"amountInUsd\":\"The equivalent amount in USD based on the oracle price.\",\"eligibleToSend\":\"A boolean indicating whether the sender is eligible to transfer the tokens.\",\"isWhiteListedUser\":\"A boolean indicating whether the sender is whitelisted.\",\"last24HourWindowStart\":\"The timestamp when the current 24-hour window started.\",\"maxDailyLimit\":\"The maximum daily limit for transactions.\",\"maxSingleTransactionLimit\":\"The maximum limit for a single transaction.\",\"transferredInWindow\":\"The total amount transferred in the current 24-hour window.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pause()\":{\"custom:access\":\"Only owner.\"},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"removeTrustedRemote(uint16)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\",\"params\":{\"remoteChainId_\":\"The chain's id corresponds to setting the trusted remote to empty.\"}},\"sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))\":{\"details\":\"This internal override function enables the contract to send tokens and invoke calls on the specified destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\",\"params\":{\"amount_\":\"Amount of tokens that will be transferred.\",\"callparams_\":\"Additional parameters, including refund address, ZRO payment address, and adapter params.\",\"dstChainId_\":\"Destination chain id on which tokens will be send.\",\"dstGasForCall_\":\"The amount of gas allocated for the call on the destination chain.\",\"from_\":\"Address from which tokens will be debited.\",\"payload_\":\"Additional data payload for the call on the destination chain.\",\"toAddress_\":\"Address on which tokens will be credited on destination chain.\"}},\"sendFrom(address,uint16,bytes32,uint256,(address,address,bytes))\":{\"details\":\"send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from` `_from` the owner of token `_dstChainId` the destination chain identifier `_toAddress` can be any size depending on the `dstChainId`. `_amount` the quantity of tokens in wei `_refundAddress` the address LayerZero refunds if too much message fee is sent `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token) `_adapterParams` is a flexible bytes array to indicate messaging adapter services\"},\"setMaxDailyLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxDailyLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"Destination chain id.\",\"limit_\":\"Amount in USD(scaled with 18 decimals).\"}},\"setMaxDailyReceiveLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"The destination chain ID.\",\"limit_\":\"The new maximum daily limit in USD(scaled with 18 decimals).\"}},\"setMaxSingleReceiveTransactionLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"The destination chain ID.\",\"limit_\":\"The new maximum limit in USD(scaled with 18 decimals).\"}},\"setMaxSingleTransactionLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"Destination chain id.\",\"limit_\":\"Amount in USD(scaled with 18 decimals).\"}},\"setOracle(address)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits OracleChanged with old and new oracle address.\",\"details\":\"Reverts if the new address is zero.\",\"params\":{\"oracleAddress_\":\"The new address of the ResilientOracle contract.\"}},\"setWhitelist(address,bool)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setWhitelist.\",\"params\":{\"user_\":\"Address to be add in whitelist.\",\"val_\":\"Boolean to be set (true for user_ address is whitelisted).\"}},\"sweepToken(address,address,uint256)\":{\"custom:access\":\"Only Owner\",\"custom:error\":\"Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\",\"custom:event\":\"Emits SweepToken event\",\"params\":{\"amount_\":\"The amount of tokens needs to transfer\",\"to_\":\"The address of the recipient\",\"token_\":\"The address of the ERC-20 token to sweep\"}},\"token()\":{\"returns\":{\"_0\":\"Address of the inner token of this bridge.\"}},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"unpause()\":{\"custom:access\":\"Only owner.\"},\"updateSendAndCallEnabled(bool)\":{\"params\":{\"enabled_\":\"Boolean indicating whether the sendAndCall function should be enabled or disabled.\"}}},\"title\":\"XVSProxyOFTDest\",\"version\":1},\"userdoc\":{\"errors\":{\"InsufficientBalance(uint256,uint256)\":[{\"notice\":\"Error thrown when this contract balance is less than sweep amount\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"DropFailedMessage(uint16,bytes,uint64)\":{\"notice\":\"Emits when stored message dropped without successful retrying.\"},\"InnerTokenAdded(address)\":{\"notice\":\"Event emitted when inner token set successfully.\"},\"OracleChanged(address,address)\":{\"notice\":\"Event emitted when oracle is modified.\"},\"SetMaxDailyLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum daily limit of transactions from local chain is modified.\"},\"SetMaxDailyReceiveLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\"},\"SetMaxSingleReceiveTransactionLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum limit for a single receive transaction from remote chain is modified.\"},\"SetMaxSingleTransactionLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum limit for a single transaction from local chain is modified.\"},\"SetWhitelist(address,bool)\":{\"notice\":\"Emitted when address is added to whitelist.\"},\"SweepToken(address,address,uint256)\":{\"notice\":\"Emitted on sweep token success\"},\"TrustedRemoteRemoved(uint16)\":{\"notice\":\"Event emitted when trusted remote sets to empty.\"},\"UpdateSendAndCallEnabled(bool)\":{\"notice\":\"Event emitted when SendAndCallEnabled updated successfully.\"}},\"kind\":\"user\",\"methods\":{\"chainIdToLast24HourReceiveWindowStart(uint16)\":{\"notice\":\"Timestamp when the last 24-hour window started from remote chain.\"},\"chainIdToLast24HourReceived(uint16)\":{\"notice\":\"Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\"},\"chainIdToLast24HourTransferred(uint16)\":{\"notice\":\"Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\"},\"chainIdToLast24HourWindowStart(uint16)\":{\"notice\":\"Timestamp when the last 24-hour window started from local chain.\"},\"chainIdToMaxDailyLimit(uint16)\":{\"notice\":\"Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\"},\"chainIdToMaxDailyReceiveLimit(uint16)\":{\"notice\":\"Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\"},\"chainIdToMaxSingleReceiveTransactionLimit(uint16)\":{\"notice\":\"Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\"},\"chainIdToMaxSingleTransactionLimit(uint16)\":{\"notice\":\"Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\"},\"circulatingSupply()\":{\"notice\":\"Returns the total circulating supply of the token on the destination chain i.e (total supply).\"},\"dropFailedMessage(uint16,bytes,uint64)\":{\"notice\":\"Clear failed messages from the storage.\"},\"isEligibleToSend(address,uint16,uint256)\":{\"notice\":\"Checks the eligibility of a sender to initiate a cross-chain token transfer.\"},\"oracle()\":{\"notice\":\"The address of ResilientOracle contract wrapped in its interface.\"},\"pause()\":{\"notice\":\"Triggers stopped state of the bridge.\"},\"removeTrustedRemote(uint16)\":{\"notice\":\"Remove trusted remote from storage.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))\":{\"notice\":\"Initiates a cross-chain token transfer and triggers a call on the destination chain.\"},\"setMaxDailyLimit(uint16,uint256)\":{\"notice\":\"Sets the limit of daily (24 Hour) transactions amount.\"},\"setMaxDailyReceiveLimit(uint16,uint256)\":{\"notice\":\"Sets the maximum daily limit for receiving transactions.\"},\"setMaxSingleReceiveTransactionLimit(uint16,uint256)\":{\"notice\":\"Sets the maximum limit for a single receive transaction.\"},\"setMaxSingleTransactionLimit(uint16,uint256)\":{\"notice\":\"Sets the limit of single transaction amount.\"},\"setOracle(address)\":{\"notice\":\"Set the address of the ResilientOracle contract.\"},\"setWhitelist(address,bool)\":{\"notice\":\"Sets the whitelist address to skip checks on transaction limit.\"},\"sweepToken(address,address,uint256)\":{\"notice\":\"A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\"},\"token()\":{\"notice\":\"Return's the address of the inner token of this bridge.\"},\"unpause()\":{\"notice\":\"Triggers resume state of the bridge.\"},\"updateSendAndCallEnabled(bool)\":{\"notice\":\"It enables or disables sendAndCall functionality for the bridge.\"},\"whitelist(address)\":{\"notice\":\"Address on which cap check and bound limit is not applicable.\"}},\"notice\":\"XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT, and focuses on managing token transfers to the destination chain. It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSProxyOFTDest.sol\":\"XVSProxyOFTDest\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@layerzerolabs/solidity-examples/contracts/libraries/BytesLib.sol\":{\"content\":\"// SPDX-License-Identifier: Unlicense\\n/*\\n * @title Solidity Bytes Arrays Utils\\n * @author Gon\\u00e7alo S\\u00e1 \\n *\\n * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.\\n * The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.\\n */\\npragma solidity >=0.8.0 <0.9.0;\\n\\nlibrary BytesLib {\\n function concat(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bytes memory) {\\n bytes memory tempBytes;\\n\\n assembly {\\n // Get a location of some free memory and store it in tempBytes as\\n // Solidity does for memory variables.\\n tempBytes := mload(0x40)\\n\\n // Store the length of the first bytes array at the beginning of\\n // the memory for tempBytes.\\n let length := mload(_preBytes)\\n mstore(tempBytes, length)\\n\\n // Maintain a memory counter for the current write location in the\\n // temp bytes array by adding the 32 bytes for the array length to\\n // the starting location.\\n let mc := add(tempBytes, 0x20)\\n // Stop copying when the memory counter reaches the length of the\\n // first bytes array.\\n let end := add(mc, length)\\n\\n for {\\n // Initialize a copy counter to the start of the _preBytes data,\\n // 32 bytes into its memory.\\n let cc := add(_preBytes, 0x20)\\n } lt(mc, end) {\\n // Increase both counters by 32 bytes each iteration.\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n // Write the _preBytes data into the tempBytes memory 32 bytes\\n // at a time.\\n mstore(mc, mload(cc))\\n }\\n\\n // Add the length of _postBytes to the current length of tempBytes\\n // and store it as the new length in the first 32 bytes of the\\n // tempBytes memory.\\n length := mload(_postBytes)\\n mstore(tempBytes, add(length, mload(tempBytes)))\\n\\n // Move the memory counter back from a multiple of 0x20 to the\\n // actual end of the _preBytes data.\\n mc := end\\n // Stop copying when the memory counter reaches the new combined\\n // length of the arrays.\\n end := add(mc, length)\\n\\n for {\\n let cc := add(_postBytes, 0x20)\\n } lt(mc, end) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n mstore(mc, mload(cc))\\n }\\n\\n // Update the free-memory pointer by padding our last write location\\n // to 32 bytes: add 31 bytes to the end of tempBytes to move to the\\n // next 32 byte block, then round down to the nearest multiple of\\n // 32. If the sum of the length of the two arrays is zero then add\\n // one before rounding down to leave a blank 32 bytes (the length block with 0).\\n mstore(\\n 0x40,\\n and(\\n add(add(end, iszero(add(length, mload(_preBytes)))), 31),\\n not(31) // Round down to the nearest 32 bytes.\\n )\\n )\\n }\\n\\n return tempBytes;\\n }\\n\\n function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {\\n assembly {\\n // Read the first 32 bytes of _preBytes storage, which is the length\\n // of the array. (We don't need to use the offset into the slot\\n // because arrays use the entire slot.)\\n let fslot := sload(_preBytes.slot)\\n // Arrays of 31 bytes or less have an even value in their slot,\\n // while longer arrays have an odd value. The actual length is\\n // the slot divided by two for odd values, and the lowest order\\n // byte divided by two for even values.\\n // If the slot is even, bitwise and the slot with 255 and divide by\\n // two to get the length. If the slot is odd, bitwise and the slot\\n // with -1 and divide by two.\\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\\n let mlength := mload(_postBytes)\\n let newlength := add(slength, mlength)\\n // slength can contain both the length and contents of the array\\n // if length < 32 bytes so let's prepare for that\\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\\n switch add(lt(slength, 32), lt(newlength, 32))\\n case 2 {\\n // Since the new array still fits in the slot, we just need to\\n // update the contents of the slot.\\n // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length\\n sstore(\\n _preBytes.slot,\\n // all the modifications to the slot are inside this\\n // next block\\n add(\\n // we can just add to the slot contents because the\\n // bytes we want to change are the LSBs\\n fslot,\\n add(\\n mul(\\n div(\\n // load the bytes from memory\\n mload(add(_postBytes, 0x20)),\\n // zero all bytes to the right\\n exp(0x100, sub(32, mlength))\\n ),\\n // and now shift left the number of bytes to\\n // leave space for the length in the slot\\n exp(0x100, sub(32, newlength))\\n ),\\n // increase length by the double of the memory\\n // bytes length\\n mul(mlength, 2)\\n )\\n )\\n )\\n }\\n case 1 {\\n // The stored value fits in the slot, but the combined value\\n // will exceed it.\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\\n\\n // save new length\\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\\n\\n // The contents of the _postBytes array start 32 bytes into\\n // the structure. Our first read should obtain the `submod`\\n // bytes that can fit into the unused space in the last word\\n // of the stored array. To get this, we read 32 bytes starting\\n // from `submod`, so the data we read overlaps with the array\\n // contents by `submod` bytes. Masking the lowest-order\\n // `submod` bytes allows us to add that value directly to the\\n // stored value.\\n\\n let submod := sub(32, slength)\\n let mc := add(_postBytes, submod)\\n let end := add(_postBytes, mlength)\\n let mask := sub(exp(0x100, submod), 1)\\n\\n sstore(sc, add(and(fslot, 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00), and(mload(mc), mask)))\\n\\n for {\\n mc := add(mc, 0x20)\\n sc := add(sc, 1)\\n } lt(mc, end) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n sstore(sc, mload(mc))\\n }\\n\\n mask := exp(0x100, sub(mc, end))\\n\\n sstore(sc, mul(div(mload(mc), mask), mask))\\n }\\n default {\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n // Start copying to the last used word of the stored array.\\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\\n\\n // save new length\\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\\n\\n // Copy over the first `submod` bytes of the new data as in\\n // case 1 above.\\n let slengthmod := mod(slength, 32)\\n let mlengthmod := mod(mlength, 32)\\n let submod := sub(32, slengthmod)\\n let mc := add(_postBytes, submod)\\n let end := add(_postBytes, mlength)\\n let mask := sub(exp(0x100, submod), 1)\\n\\n sstore(sc, add(sload(sc), and(mload(mc), mask)))\\n\\n for {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } lt(mc, end) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n sstore(sc, mload(mc))\\n }\\n\\n mask := exp(0x100, sub(mc, end))\\n\\n sstore(sc, mul(div(mload(mc), mask), mask))\\n }\\n }\\n }\\n\\n function slice(\\n bytes memory _bytes,\\n uint _start,\\n uint _length\\n ) internal pure returns (bytes memory) {\\n require(_length + 31 >= _length, \\\"slice_overflow\\\");\\n require(_bytes.length >= _start + _length, \\\"slice_outOfBounds\\\");\\n\\n bytes memory tempBytes;\\n\\n assembly {\\n switch iszero(_length)\\n case 0 {\\n // Get a location of some free memory and store it in tempBytes as\\n // Solidity does for memory variables.\\n tempBytes := mload(0x40)\\n\\n // The first word of the slice result is potentially a partial\\n // word read from the original array. To read it, we calculate\\n // the length of that partial word and start copying that many\\n // bytes into the array. The first word we copy will start with\\n // data we don't care about, but the last `lengthmod` bytes will\\n // land at the beginning of the contents of the new array. When\\n // we're done copying, we overwrite the full first word with\\n // the actual length of the slice.\\n let lengthmod := and(_length, 31)\\n\\n // The multiplication in the next line is necessary\\n // because when slicing multiples of 32 bytes (lengthmod == 0)\\n // the following copy loop was copying the origin's length\\n // and then ending prematurely not copying everything it should.\\n let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))\\n let end := add(mc, _length)\\n\\n for {\\n // The multiplication in the next line has the same exact purpose\\n // as the one above.\\n let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)\\n } lt(mc, end) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n mstore(mc, mload(cc))\\n }\\n\\n mstore(tempBytes, _length)\\n\\n //update free-memory pointer\\n //allocating the array padded to 32 bytes like the compiler does now\\n mstore(0x40, and(add(mc, 31), not(31)))\\n }\\n //if we want a zero-length slice let's just return a zero-length array\\n default {\\n tempBytes := mload(0x40)\\n //zero out the 32 bytes slice we are about to return\\n //we need to do it because Solidity does not garbage collect\\n mstore(tempBytes, 0)\\n\\n mstore(0x40, add(tempBytes, 0x20))\\n }\\n }\\n\\n return tempBytes;\\n }\\n\\n function toAddress(bytes memory _bytes, uint _start) internal pure returns (address) {\\n require(_bytes.length >= _start + 20, \\\"toAddress_outOfBounds\\\");\\n address tempAddress;\\n\\n assembly {\\n tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)\\n }\\n\\n return tempAddress;\\n }\\n\\n function toUint8(bytes memory _bytes, uint _start) internal pure returns (uint8) {\\n require(_bytes.length >= _start + 1, \\\"toUint8_outOfBounds\\\");\\n uint8 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x1), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint16(bytes memory _bytes, uint _start) internal pure returns (uint16) {\\n require(_bytes.length >= _start + 2, \\\"toUint16_outOfBounds\\\");\\n uint16 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x2), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint32(bytes memory _bytes, uint _start) internal pure returns (uint32) {\\n require(_bytes.length >= _start + 4, \\\"toUint32_outOfBounds\\\");\\n uint32 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x4), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint64(bytes memory _bytes, uint _start) internal pure returns (uint64) {\\n require(_bytes.length >= _start + 8, \\\"toUint64_outOfBounds\\\");\\n uint64 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x8), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint96(bytes memory _bytes, uint _start) internal pure returns (uint96) {\\n require(_bytes.length >= _start + 12, \\\"toUint96_outOfBounds\\\");\\n uint96 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0xc), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint128(bytes memory _bytes, uint _start) internal pure returns (uint128) {\\n require(_bytes.length >= _start + 16, \\\"toUint128_outOfBounds\\\");\\n uint128 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x10), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint256(bytes memory _bytes, uint _start) internal pure returns (uint) {\\n require(_bytes.length >= _start + 32, \\\"toUint256_outOfBounds\\\");\\n uint tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x20), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toBytes32(bytes memory _bytes, uint _start) internal pure returns (bytes32) {\\n require(_bytes.length >= _start + 32, \\\"toBytes32_outOfBounds\\\");\\n bytes32 tempBytes32;\\n\\n assembly {\\n tempBytes32 := mload(add(add(_bytes, 0x20), _start))\\n }\\n\\n return tempBytes32;\\n }\\n\\n function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {\\n bool success = true;\\n\\n assembly {\\n let length := mload(_preBytes)\\n\\n // if lengths don't match the arrays are not equal\\n switch eq(length, mload(_postBytes))\\n case 1 {\\n // cb is a circuit breaker in the for loop since there's\\n // no said feature for inline assembly loops\\n // cb = 1 - don't breaker\\n // cb = 0 - break\\n let cb := 1\\n\\n let mc := add(_preBytes, 0x20)\\n let end := add(mc, length)\\n\\n for {\\n let cc := add(_postBytes, 0x20)\\n // the next line is the loop condition:\\n // while(uint256(mc < end) + cb == 2)\\n } eq(add(lt(mc, end), cb), 2) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n // if any of these checks fails then arrays are not equal\\n if iszero(eq(mload(mc), mload(cc))) {\\n // unsuccess:\\n success := 0\\n cb := 0\\n }\\n }\\n }\\n default {\\n // unsuccess:\\n success := 0\\n }\\n }\\n\\n return success;\\n }\\n\\n function equalStorage(bytes storage _preBytes, bytes memory _postBytes) internal view returns (bool) {\\n bool success = true;\\n\\n assembly {\\n // we know _preBytes_offset is 0\\n let fslot := sload(_preBytes.slot)\\n // Decode the length of the stored array like in concatStorage().\\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\\n let mlength := mload(_postBytes)\\n\\n // if lengths don't match the arrays are not equal\\n switch eq(slength, mlength)\\n case 1 {\\n // slength can contain both the length and contents of the array\\n // if length < 32 bytes so let's prepare for that\\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\\n if iszero(iszero(slength)) {\\n switch lt(slength, 32)\\n case 1 {\\n // blank the last byte which is the length\\n fslot := mul(div(fslot, 0x100), 0x100)\\n\\n if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {\\n // unsuccess:\\n success := 0\\n }\\n }\\n default {\\n // cb is a circuit breaker in the for loop since there's\\n // no said feature for inline assembly loops\\n // cb = 1 - don't breaker\\n // cb = 0 - break\\n let cb := 1\\n\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n let sc := keccak256(0x0, 0x20)\\n\\n let mc := add(_postBytes, 0x20)\\n let end := add(mc, mlength)\\n\\n // the next line is the loop condition:\\n // while(uint256(mc < end) + cb == 2)\\n for {\\n\\n } eq(add(lt(mc, end), cb), 2) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n if iszero(eq(sload(sc), mload(mc))) {\\n // unsuccess:\\n success := 0\\n cb := 0\\n }\\n }\\n }\\n }\\n }\\n default {\\n // unsuccess:\\n success := 0\\n }\\n }\\n\\n return success;\\n }\\n}\\n\",\"keccak256\":\"0x7e64cccdf22a03f513d94960f2145dd801fb5ec88d971de079b5186a9f5e93c4\",\"license\":\"Unlicense\"},\"@layerzerolabs/solidity-examples/contracts/libraries/ExcessivelySafeCall.sol\":{\"content\":\"// SPDX-License-Identifier: MIT OR Apache-2.0\\npragma solidity >=0.7.6;\\n\\nlibrary ExcessivelySafeCall {\\n uint constant LOW_28_MASK = 0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;\\n\\n /// @notice Use when you _really_ really _really_ don't trust the called\\n /// contract. This prevents the called contract from causing reversion of\\n /// the caller in as many ways as we can.\\n /// @dev The main difference between this and a solidity low-level call is\\n /// that we limit the number of bytes that the callee can cause to be\\n /// copied to caller memory. This prevents stupid things like malicious\\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\\n /// to memory.\\n /// @param _target The address to call\\n /// @param _gas The amount of gas to forward to the remote contract\\n /// @param _maxCopy The maximum number of bytes of returndata to copy\\n /// to memory.\\n /// @param _calldata The data to send to the remote contract\\n /// @return success and returndata, as `.call()`. Returndata is capped to\\n /// `_maxCopy` bytes.\\n function excessivelySafeCall(\\n address _target,\\n uint _gas,\\n uint16 _maxCopy,\\n bytes memory _calldata\\n ) internal returns (bool, bytes memory) {\\n // set up for assembly call\\n uint _toCopy;\\n bool _success;\\n bytes memory _returnData = new bytes(_maxCopy);\\n // dispatch message to recipient\\n // by assembly calling \\\"handle\\\" function\\n // we call via assembly to avoid memcopying a very large returndata\\n // returned by a malicious contract\\n assembly {\\n _success := call(\\n _gas, // gas\\n _target, // recipient\\n 0, // ether value\\n add(_calldata, 0x20), // inloc\\n mload(_calldata), // inlen\\n 0, // outloc\\n 0 // outlen\\n )\\n // limit our copy to 256 bytes\\n _toCopy := returndatasize()\\n if gt(_toCopy, _maxCopy) {\\n _toCopy := _maxCopy\\n }\\n // Store the length of the copied bytes\\n mstore(_returnData, _toCopy)\\n // copy the bytes from returndata[0:_toCopy]\\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\\n }\\n return (_success, _returnData);\\n }\\n\\n /// @notice Use when you _really_ really _really_ don't trust the called\\n /// contract. This prevents the called contract from causing reversion of\\n /// the caller in as many ways as we can.\\n /// @dev The main difference between this and a solidity low-level call is\\n /// that we limit the number of bytes that the callee can cause to be\\n /// copied to caller memory. This prevents stupid things like malicious\\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\\n /// to memory.\\n /// @param _target The address to call\\n /// @param _gas The amount of gas to forward to the remote contract\\n /// @param _maxCopy The maximum number of bytes of returndata to copy\\n /// to memory.\\n /// @param _calldata The data to send to the remote contract\\n /// @return success and returndata, as `.call()`. Returndata is capped to\\n /// `_maxCopy` bytes.\\n function excessivelySafeStaticCall(\\n address _target,\\n uint _gas,\\n uint16 _maxCopy,\\n bytes memory _calldata\\n ) internal view returns (bool, bytes memory) {\\n // set up for assembly call\\n uint _toCopy;\\n bool _success;\\n bytes memory _returnData = new bytes(_maxCopy);\\n // dispatch message to recipient\\n // by assembly calling \\\"handle\\\" function\\n // we call via assembly to avoid memcopying a very large returndata\\n // returned by a malicious contract\\n assembly {\\n _success := staticcall(\\n _gas, // gas\\n _target, // recipient\\n add(_calldata, 0x20), // inloc\\n mload(_calldata), // inlen\\n 0, // outloc\\n 0 // outlen\\n )\\n // limit our copy to 256 bytes\\n _toCopy := returndatasize()\\n if gt(_toCopy, _maxCopy) {\\n _toCopy := _maxCopy\\n }\\n // Store the length of the copied bytes\\n mstore(_returnData, _toCopy)\\n // copy the bytes from returndata[0:_toCopy]\\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\\n }\\n return (_success, _returnData);\\n }\\n\\n /**\\n * @notice Swaps function selectors in encoded contract calls\\n * @dev Allows reuse of encoded calldata for functions with identical\\n * argument types but different names. It simply swaps out the first 4 bytes\\n * for the new selector. This function modifies memory in place, and should\\n * only be used with caution.\\n * @param _newSelector The new 4-byte selector\\n * @param _buf The encoded contract args\\n */\\n function swapSelector(bytes4 _newSelector, bytes memory _buf) internal pure {\\n require(_buf.length >= 4);\\n uint _mask = LOW_28_MASK;\\n assembly {\\n // load the first word of\\n let _word := mload(add(_buf, 0x20))\\n // mask out the top 4 bytes\\n // /x\\n _word := and(_word, _mask)\\n _word := or(_newSelector, _word)\\n mstore(add(_buf, 0x20), _word)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xd4e52af409b5ec80432292d86fb01906785eb78ac31da3bab4565aabcd6e3e56\",\"license\":\"MIT OR Apache-2.0\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/LzApp.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\nimport \\\"./interfaces/ILayerZeroReceiver.sol\\\";\\nimport \\\"./interfaces/ILayerZeroUserApplicationConfig.sol\\\";\\nimport \\\"./interfaces/ILayerZeroEndpoint.sol\\\";\\nimport \\\"../libraries/BytesLib.sol\\\";\\n\\n/*\\n * a generic LzReceiver implementation\\n */\\nabstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {\\n using BytesLib for bytes;\\n\\n // ua can not send payload larger than this by default, but it can be changed by the ua owner\\n uint public constant DEFAULT_PAYLOAD_SIZE_LIMIT = 10000;\\n\\n ILayerZeroEndpoint public immutable lzEndpoint;\\n mapping(uint16 => bytes) public trustedRemoteLookup;\\n mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;\\n mapping(uint16 => uint) public payloadSizeLimitLookup;\\n address public precrime;\\n\\n event SetPrecrime(address precrime);\\n event SetTrustedRemote(uint16 _remoteChainId, bytes _path);\\n event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);\\n event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);\\n\\n constructor(address _endpoint) {\\n lzEndpoint = ILayerZeroEndpoint(_endpoint);\\n }\\n\\n function lzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public virtual override {\\n // lzReceive must be called by the endpoint for security\\n require(_msgSender() == address(lzEndpoint), \\\"LzApp: invalid endpoint caller\\\");\\n\\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\\n // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\\n require(\\n _srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote),\\n \\\"LzApp: invalid source sending contract\\\"\\n );\\n\\n _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging\\n function _blockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual;\\n\\n function _lzSend(\\n uint16 _dstChainId,\\n bytes memory _payload,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams,\\n uint _nativeFee\\n ) internal virtual {\\n bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];\\n require(trustedRemote.length != 0, \\\"LzApp: destination chain is not a trusted source\\\");\\n _checkPayloadSize(_dstChainId, _payload.length);\\n lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);\\n }\\n\\n function _checkGasLimit(\\n uint16 _dstChainId,\\n uint16 _type,\\n bytes memory _adapterParams,\\n uint _extraGas\\n ) internal view virtual {\\n uint providedGasLimit = _getGasLimit(_adapterParams);\\n uint minGasLimit = minDstGasLookup[_dstChainId][_type];\\n require(minGasLimit > 0, \\\"LzApp: minGasLimit not set\\\");\\n require(providedGasLimit >= minGasLimit + _extraGas, \\\"LzApp: gas limit is too low\\\");\\n }\\n\\n function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {\\n require(_adapterParams.length >= 34, \\\"LzApp: invalid adapterParams\\\");\\n assembly {\\n gasLimit := mload(add(_adapterParams, 34))\\n }\\n }\\n\\n function _checkPayloadSize(uint16 _dstChainId, uint _payloadSize) internal view virtual {\\n uint payloadSizeLimit = payloadSizeLimitLookup[_dstChainId];\\n if (payloadSizeLimit == 0) {\\n // use default if not set\\n payloadSizeLimit = DEFAULT_PAYLOAD_SIZE_LIMIT;\\n }\\n require(_payloadSize <= payloadSizeLimit, \\\"LzApp: payload size is too large\\\");\\n }\\n\\n //---------------------------UserApplication config----------------------------------------\\n function getConfig(\\n uint16 _version,\\n uint16 _chainId,\\n address,\\n uint _configType\\n ) external view returns (bytes memory) {\\n return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);\\n }\\n\\n // generic config for LayerZero user Application\\n function setConfig(\\n uint16 _version,\\n uint16 _chainId,\\n uint _configType,\\n bytes calldata _config\\n ) external override onlyOwner {\\n lzEndpoint.setConfig(_version, _chainId, _configType, _config);\\n }\\n\\n function setSendVersion(uint16 _version) external override onlyOwner {\\n lzEndpoint.setSendVersion(_version);\\n }\\n\\n function setReceiveVersion(uint16 _version) external override onlyOwner {\\n lzEndpoint.setReceiveVersion(_version);\\n }\\n\\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {\\n lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);\\n }\\n\\n // _path = abi.encodePacked(remoteAddress, localAddress)\\n // this function set the trusted path for the cross-chain communication\\n function setTrustedRemote(uint16 _remoteChainId, bytes calldata _path) external onlyOwner {\\n trustedRemoteLookup[_remoteChainId] = _path;\\n emit SetTrustedRemote(_remoteChainId, _path);\\n }\\n\\n function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {\\n trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));\\n emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);\\n }\\n\\n function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {\\n bytes memory path = trustedRemoteLookup[_remoteChainId];\\n require(path.length != 0, \\\"LzApp: no trusted path record\\\");\\n return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)\\n }\\n\\n function setPrecrime(address _precrime) external onlyOwner {\\n precrime = _precrime;\\n emit SetPrecrime(_precrime);\\n }\\n\\n function setMinDstGas(\\n uint16 _dstChainId,\\n uint16 _packetType,\\n uint _minGas\\n ) external onlyOwner {\\n minDstGasLookup[_dstChainId][_packetType] = _minGas;\\n emit SetMinDstGas(_dstChainId, _packetType, _minGas);\\n }\\n\\n // if the size is 0, it means default size limit\\n function setPayloadSizeLimit(uint16 _dstChainId, uint _size) external onlyOwner {\\n payloadSizeLimitLookup[_dstChainId] = _size;\\n }\\n\\n //--------------------------- VIEW FUNCTION ----------------------------------------\\n function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {\\n bytes memory trustedSource = trustedRemoteLookup[_srcChainId];\\n return keccak256(trustedSource) == keccak256(_srcAddress);\\n }\\n}\\n\",\"keccak256\":\"0x309c994bdcf69ad63c6789694a28eb72a773e2d9db58fe572ab2b34a475972ce\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/NonblockingLzApp.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./LzApp.sol\\\";\\nimport \\\"../libraries/ExcessivelySafeCall.sol\\\";\\n\\n/*\\n * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel\\n * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking\\n * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)\\n */\\nabstract contract NonblockingLzApp is LzApp {\\n using ExcessivelySafeCall for address;\\n\\n constructor(address _endpoint) LzApp(_endpoint) {}\\n\\n mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;\\n\\n event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);\\n event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);\\n\\n // overriding the virtual function in LzReceiver\\n function _blockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual override {\\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\\n gasleft(),\\n 150,\\n abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload)\\n );\\n // try-catch all errors/exceptions\\n if (!success) {\\n _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);\\n }\\n }\\n\\n function _storeFailedMessage(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload,\\n bytes memory _reason\\n ) internal virtual {\\n failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);\\n emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);\\n }\\n\\n function nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public virtual {\\n // only internal transaction\\n require(_msgSender() == address(this), \\\"NonblockingLzApp: caller must be LzApp\\\");\\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n //@notice override this function\\n function _nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual;\\n\\n function retryMessage(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public payable virtual {\\n // assert there is message to retry\\n bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];\\n require(payloadHash != bytes32(0), \\\"NonblockingLzApp: no stored message\\\");\\n require(keccak256(_payload) == payloadHash, \\\"NonblockingLzApp: invalid payload\\\");\\n // clear the stored message\\n failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);\\n // execute the message. revert if it fails again\\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);\\n }\\n}\\n\",\"keccak256\":\"0x612ff1f2a158b7e64e873885b5ff08afa348998fd9005f384d555d643ba7968d\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroEndpoint.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"./ILayerZeroUserApplicationConfig.sol\\\";\\n\\ninterface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {\\n // @notice send a LayerZero message to the specified address at a LayerZero endpoint.\\n // @param _dstChainId - the destination chain identifier\\n // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains\\n // @param _payload - a custom bytes payload to send to the destination contract\\n // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address\\n // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction\\n // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination\\n function send(\\n uint16 _dstChainId,\\n bytes calldata _destination,\\n bytes calldata _payload,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes calldata _adapterParams\\n ) external payable;\\n\\n // @notice used by the messaging library to publish verified payload\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source contract (as bytes) at the source chain\\n // @param _dstAddress - the address on destination chain\\n // @param _nonce - the unbound message ordering nonce\\n // @param _gasLimit - the gas limit for external contract execution\\n // @param _payload - verified payload to send to the destination contract\\n function receivePayload(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n address _dstAddress,\\n uint64 _nonce,\\n uint _gasLimit,\\n bytes calldata _payload\\n ) external;\\n\\n // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);\\n\\n // @notice get the outboundNonce from this source chain which, consequently, is always an EVM\\n // @param _srcAddress - the source chain contract address\\n function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);\\n\\n // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery\\n // @param _dstChainId - the destination chain identifier\\n // @param _userApplication - the user app address on this EVM chain\\n // @param _payload - the custom message to send over LayerZero\\n // @param _payInZRO - if false, user app pays the protocol fee in native token\\n // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain\\n function estimateFees(\\n uint16 _dstChainId,\\n address _userApplication,\\n bytes calldata _payload,\\n bool _payInZRO,\\n bytes calldata _adapterParam\\n ) external view returns (uint nativeFee, uint zroFee);\\n\\n // @notice get this Endpoint's immutable source identifier\\n function getChainId() external view returns (uint16);\\n\\n // @notice the interface to retry failed message on this Endpoint destination\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n // @param _payload - the payload to be retried\\n function retryPayload(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n bytes calldata _payload\\n ) external;\\n\\n // @notice query if any STORED payload (message blocking) at the endpoint.\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);\\n\\n // @notice query if the _libraryAddress is valid for sending msgs.\\n // @param _userApplication - the user app address on this EVM chain\\n function getSendLibraryAddress(address _userApplication) external view returns (address);\\n\\n // @notice query if the _libraryAddress is valid for receiving msgs.\\n // @param _userApplication - the user app address on this EVM chain\\n function getReceiveLibraryAddress(address _userApplication) external view returns (address);\\n\\n // @notice query if the non-reentrancy guard for send() is on\\n // @return true if the guard is on. false otherwise\\n function isSendingPayload() external view returns (bool);\\n\\n // @notice query if the non-reentrancy guard for receive() is on\\n // @return true if the guard is on. false otherwise\\n function isReceivingPayload() external view returns (bool);\\n\\n // @notice get the configuration of the LayerZero messaging library of the specified version\\n // @param _version - messaging library version\\n // @param _chainId - the chainId for the pending config change\\n // @param _userApplication - the contract address of the user application\\n // @param _configType - type of configuration. every messaging library has its own convention.\\n function getConfig(\\n uint16 _version,\\n uint16 _chainId,\\n address _userApplication,\\n uint _configType\\n ) external view returns (bytes memory);\\n\\n // @notice get the send() LayerZero messaging library version\\n // @param _userApplication - the contract address of the user application\\n function getSendVersion(address _userApplication) external view returns (uint16);\\n\\n // @notice get the lzReceive() LayerZero messaging library version\\n // @param _userApplication - the contract address of the user application\\n function getReceiveVersion(address _userApplication) external view returns (uint16);\\n}\\n\",\"keccak256\":\"0xab7fcacc672251c850f00c0abd4100df9afcc4ad70b8d331a2fd4cb07acab9f4\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroReceiver.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\ninterface ILayerZeroReceiver {\\n // @notice LayerZero endpoint will invoke this function to deliver the message on the destination\\n // @param _srcChainId - the source endpoint identifier\\n // @param _srcAddress - the source sending contract address from the source chain\\n // @param _nonce - the ordered message nonce\\n // @param _payload - the signed payload is the UA bytes has encoded to be sent\\n function lzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) external;\\n}\\n\",\"keccak256\":\"0xac1966c1229bd4dc36b6c69eeb94a537bd9aa2198d7623b9ba7f8f7dbe79bb4c\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroUserApplicationConfig.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\ninterface ILayerZeroUserApplicationConfig {\\n // @notice set the configuration of the LayerZero messaging library of the specified version\\n // @param _version - messaging library version\\n // @param _chainId - the chainId for the pending config change\\n // @param _configType - type of configuration. every messaging library has its own convention.\\n // @param _config - configuration in the bytes. can encode arbitrary content.\\n function setConfig(\\n uint16 _version,\\n uint16 _chainId,\\n uint _configType,\\n bytes calldata _config\\n ) external;\\n\\n // @notice set the send() LayerZero messaging library version to _version\\n // @param _version - new messaging library version\\n function setSendVersion(uint16 _version) external;\\n\\n // @notice set the lzReceive() LayerZero messaging library version to _version\\n // @param _version - new messaging library version\\n function setReceiveVersion(uint16 _version) external;\\n\\n // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload\\n // @param _srcChainId - the chainId of the source chain\\n // @param _srcAddress - the contract address of the source contract at the source chain\\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;\\n}\\n\",\"keccak256\":\"0xb4df93aeb0fb46373a4fb728ad2603edc8b9a1577eee8d801768dc115bf96498\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OFTCoreV2.sol\\\";\\nimport \\\"./interfaces/IOFTV2.sol\\\";\\nimport \\\"@openzeppelin/contracts/utils/introspection/ERC165.sol\\\";\\n\\nabstract contract BaseOFTV2 is OFTCoreV2, ERC165, IOFTV2 {\\n constructor(uint8 _sharedDecimals, address _lzEndpoint) OFTCoreV2(_sharedDecimals, _lzEndpoint) {}\\n\\n /************************************************************************\\n * public functions\\n ************************************************************************/\\n function sendFrom(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n LzCallParams calldata _callParams\\n ) public payable virtual override {\\n _send(_from, _dstChainId, _toAddress, _amount, _callParams.refundAddress, _callParams.zroPaymentAddress, _callParams.adapterParams);\\n }\\n\\n function sendAndCall(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes calldata _payload,\\n uint64 _dstGasForCall,\\n LzCallParams calldata _callParams\\n ) public payable virtual override {\\n _sendAndCall(\\n _from,\\n _dstChainId,\\n _toAddress,\\n _amount,\\n _payload,\\n _dstGasForCall,\\n _callParams.refundAddress,\\n _callParams.zroPaymentAddress,\\n _callParams.adapterParams\\n );\\n }\\n\\n /************************************************************************\\n * public view functions\\n ************************************************************************/\\n function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {\\n return interfaceId == type(IOFTV2).interfaceId || super.supportsInterface(interfaceId);\\n }\\n\\n function estimateSendFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bool _useZro,\\n bytes calldata _adapterParams\\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\\n return _estimateSendFee(_dstChainId, _toAddress, _amount, _useZro, _adapterParams);\\n }\\n\\n function estimateSendAndCallFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes calldata _payload,\\n uint64 _dstGasForCall,\\n bool _useZro,\\n bytes calldata _adapterParams\\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\\n return _estimateSendAndCallFee(_dstChainId, _toAddress, _amount, _payload, _dstGasForCall, _useZro, _adapterParams);\\n }\\n\\n function circulatingSupply() public view virtual override returns (uint);\\n\\n function token() public view virtual override returns (address);\\n}\\n\",\"keccak256\":\"0x59d2d32dd14a4f58232b126a7d69608a85f82137bd56d8ce0fc28ff646cba943\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/OFTCoreV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../../../lzApp/NonblockingLzApp.sol\\\";\\nimport \\\"../../../libraries/ExcessivelySafeCall.sol\\\";\\nimport \\\"./interfaces/ICommonOFT.sol\\\";\\nimport \\\"./interfaces/IOFTReceiverV2.sol\\\";\\n\\nabstract contract OFTCoreV2 is NonblockingLzApp {\\n using BytesLib for bytes;\\n using ExcessivelySafeCall for address;\\n\\n uint public constant NO_EXTRA_GAS = 0;\\n\\n // packet type\\n uint8 public constant PT_SEND = 0;\\n uint8 public constant PT_SEND_AND_CALL = 1;\\n\\n uint8 public immutable sharedDecimals;\\n\\n mapping(uint16 => mapping(bytes => mapping(uint64 => bool))) public creditedPackets;\\n\\n /**\\n * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)\\n * `_nonce` is the outbound nonce\\n */\\n event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes32 indexed _toAddress, uint _amount);\\n\\n /**\\n * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.\\n * `_nonce` is the inbound nonce.\\n */\\n event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);\\n\\n event CallOFTReceivedSuccess(uint16 indexed _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _hash);\\n\\n event NonContractAddress(address _address);\\n\\n // _sharedDecimals should be the minimum decimals on all chains\\n constructor(uint8 _sharedDecimals, address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {\\n sharedDecimals = _sharedDecimals;\\n }\\n\\n /************************************************************************\\n * public functions\\n ************************************************************************/\\n function callOnOFTReceived(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes32 _from,\\n address _to,\\n uint _amount,\\n bytes calldata _payload,\\n uint _gasForCall\\n ) public virtual {\\n require(_msgSender() == address(this), \\\"OFTCore: caller must be OFTCore\\\");\\n\\n // send\\n _amount = _transferFrom(address(this), _to, _amount);\\n emit ReceiveFromChain(_srcChainId, _to, _amount);\\n\\n // call\\n IOFTReceiverV2(_to).onOFTReceived{gas: _gasForCall}(_srcChainId, _srcAddress, _nonce, _from, _amount, _payload);\\n }\\n\\n /************************************************************************\\n * internal functions\\n ************************************************************************/\\n function _estimateSendFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bool _useZro,\\n bytes memory _adapterParams\\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\\n // mock the payload for sendFrom()\\n bytes memory payload = _encodeSendPayload(_toAddress, _ld2sd(_amount));\\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\\n }\\n\\n function _estimateSendAndCallFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes memory _payload,\\n uint64 _dstGasForCall,\\n bool _useZro,\\n bytes memory _adapterParams\\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\\n // mock the payload for sendAndCall()\\n bytes memory payload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(_amount), _payload, _dstGasForCall);\\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\\n }\\n\\n function _nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual override {\\n uint8 packetType = _payload.toUint8(0);\\n\\n if (packetType == PT_SEND) {\\n _sendAck(_srcChainId, _srcAddress, _nonce, _payload);\\n } else if (packetType == PT_SEND_AND_CALL) {\\n _sendAndCallAck(_srcChainId, _srcAddress, _nonce, _payload);\\n } else {\\n revert(\\\"OFTCore: unknown packet type\\\");\\n }\\n }\\n\\n function _send(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams\\n ) internal virtual returns (uint amount) {\\n _checkGasLimit(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);\\n\\n (amount, ) = _removeDust(_amount);\\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount); // amount returned should not have dust\\n require(amount > 0, \\\"OFTCore: amount too small\\\");\\n\\n bytes memory lzPayload = _encodeSendPayload(_toAddress, _ld2sd(amount));\\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\\n\\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\\n }\\n\\n function _sendAck(\\n uint16 _srcChainId,\\n bytes memory,\\n uint64,\\n bytes memory _payload\\n ) internal virtual {\\n (address to, uint64 amountSD) = _decodeSendPayload(_payload);\\n if (to == address(0)) {\\n to = address(0xdead);\\n }\\n\\n uint amount = _sd2ld(amountSD);\\n amount = _creditTo(_srcChainId, to, amount);\\n\\n emit ReceiveFromChain(_srcChainId, to, amount);\\n }\\n\\n function _sendAndCall(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes memory _payload,\\n uint64 _dstGasForCall,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams\\n ) internal virtual returns (uint amount) {\\n _checkGasLimit(_dstChainId, PT_SEND_AND_CALL, _adapterParams, _dstGasForCall);\\n\\n (amount, ) = _removeDust(_amount);\\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount);\\n require(amount > 0, \\\"OFTCore: amount too small\\\");\\n\\n // encode the msg.sender into the payload instead of _from\\n bytes memory lzPayload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(amount), _payload, _dstGasForCall);\\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\\n\\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\\n }\\n\\n function _sendAndCallAck(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual {\\n (bytes32 from, address to, uint64 amountSD, bytes memory payloadForCall, uint64 gasForCall) = _decodeSendAndCallPayload(_payload);\\n\\n bool credited = creditedPackets[_srcChainId][_srcAddress][_nonce];\\n uint amount = _sd2ld(amountSD);\\n\\n // credit to this contract first, and then transfer to receiver only if callOnOFTReceived() succeeds\\n if (!credited) {\\n amount = _creditTo(_srcChainId, address(this), amount);\\n creditedPackets[_srcChainId][_srcAddress][_nonce] = true;\\n }\\n\\n if (!_isContract(to)) {\\n emit NonContractAddress(to);\\n return;\\n }\\n\\n // workaround for stack too deep\\n uint16 srcChainId = _srcChainId;\\n bytes memory srcAddress = _srcAddress;\\n uint64 nonce = _nonce;\\n bytes memory payload = _payload;\\n bytes32 from_ = from;\\n address to_ = to;\\n uint amount_ = amount;\\n bytes memory payloadForCall_ = payloadForCall;\\n\\n // no gas limit for the call if retry\\n uint gas = credited ? gasleft() : gasForCall;\\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\\n gasleft(),\\n 150,\\n abi.encodeWithSelector(this.callOnOFTReceived.selector, srcChainId, srcAddress, nonce, from_, to_, amount_, payloadForCall_, gas)\\n );\\n\\n if (success) {\\n bytes32 hash = keccak256(payload);\\n emit CallOFTReceivedSuccess(srcChainId, srcAddress, nonce, hash);\\n } else {\\n // store the failed message into the nonblockingLzApp\\n _storeFailedMessage(srcChainId, srcAddress, nonce, payload, reason);\\n }\\n }\\n\\n function _isContract(address _account) internal view returns (bool) {\\n return _account.code.length > 0;\\n }\\n\\n function _ld2sd(uint _amount) internal view virtual returns (uint64) {\\n uint amountSD = _amount / _ld2sdRate();\\n require(amountSD <= type(uint64).max, \\\"OFTCore: amountSD overflow\\\");\\n return uint64(amountSD);\\n }\\n\\n function _sd2ld(uint64 _amountSD) internal view virtual returns (uint) {\\n return _amountSD * _ld2sdRate();\\n }\\n\\n function _removeDust(uint _amount) internal view virtual returns (uint amountAfter, uint dust) {\\n dust = _amount % _ld2sdRate();\\n amountAfter = _amount - dust;\\n }\\n\\n function _encodeSendPayload(bytes32 _toAddress, uint64 _amountSD) internal view virtual returns (bytes memory) {\\n return abi.encodePacked(PT_SEND, _toAddress, _amountSD);\\n }\\n\\n function _decodeSendPayload(bytes memory _payload) internal view virtual returns (address to, uint64 amountSD) {\\n require(_payload.toUint8(0) == PT_SEND && _payload.length == 41, \\\"OFTCore: invalid payload\\\");\\n\\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\\n amountSD = _payload.toUint64(33);\\n }\\n\\n function _encodeSendAndCallPayload(\\n address _from,\\n bytes32 _toAddress,\\n uint64 _amountSD,\\n bytes memory _payload,\\n uint64 _dstGasForCall\\n ) internal view virtual returns (bytes memory) {\\n return abi.encodePacked(PT_SEND_AND_CALL, _toAddress, _amountSD, _addressToBytes32(_from), _dstGasForCall, _payload);\\n }\\n\\n function _decodeSendAndCallPayload(bytes memory _payload)\\n internal\\n view\\n virtual\\n returns (\\n bytes32 from,\\n address to,\\n uint64 amountSD,\\n bytes memory payload,\\n uint64 dstGasForCall\\n )\\n {\\n require(_payload.toUint8(0) == PT_SEND_AND_CALL, \\\"OFTCore: invalid payload\\\");\\n\\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\\n amountSD = _payload.toUint64(33);\\n from = _payload.toBytes32(41);\\n dstGasForCall = _payload.toUint64(73);\\n payload = _payload.slice(81, _payload.length - 81);\\n }\\n\\n function _addressToBytes32(address _address) internal pure virtual returns (bytes32) {\\n return bytes32(uint(uint160(_address)));\\n }\\n\\n function _debitFrom(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _creditTo(\\n uint16 _srcChainId,\\n address _toAddress,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _transferFrom(\\n address _from,\\n address _to,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _ld2sdRate() internal view virtual returns (uint);\\n}\\n\",\"keccak256\":\"0x96cf7a10c5af4243822d25e77985a4a46d12264f839593ded5378cd6519a8df0\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/ICommonOFT.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"@openzeppelin/contracts/utils/introspection/IERC165.sol\\\";\\n\\n/**\\n * @dev Interface of the IOFT core standard\\n */\\ninterface ICommonOFT is IERC165 {\\n\\n struct LzCallParams {\\n address payable refundAddress;\\n address zroPaymentAddress;\\n bytes adapterParams;\\n }\\n\\n /**\\n * @dev estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`)\\n * _dstChainId - L0 defined chain id to send tokens too\\n * _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain\\n * _amount - amount of the tokens to transfer\\n * _useZro - indicates to use zro to pay L0 fees\\n * _adapterParam - flexible bytes array to indicate messaging adapter services in L0\\n */\\n function estimateSendFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\\n\\n function estimateSendAndCallFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\\n\\n /**\\n * @dev returns the circulating amount of tokens on current chain\\n */\\n function circulatingSupply() external view returns (uint);\\n\\n /**\\n * @dev returns the address of the ERC20 token\\n */\\n function token() external view returns (address);\\n}\\n\",\"keccak256\":\"0x1d034ba786436c1fce8057352c87373098bd1d8026b24c8fbc7be28636d0c15d\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTReceiverV2.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\n\\npragma solidity >=0.5.0;\\n\\ninterface IOFTReceiverV2 {\\n /**\\n * @dev Called by the OFT contract when tokens are received from source chain.\\n * @param _srcChainId The chain id of the source chain.\\n * @param _srcAddress The address of the OFT token contract on the source chain.\\n * @param _nonce The nonce of the transaction on the source chain.\\n * @param _from The address of the account who calls the sendAndCall() on the source chain.\\n * @param _amount The amount of tokens to transfer.\\n * @param _payload Additional data with no specified format.\\n */\\n function onOFTReceived(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes32 _from, uint _amount, bytes calldata _payload) external;\\n}\\n\",\"keccak256\":\"0xf57e437ced3bc10bb333123bb49475dab47c7615b86401c4d872c29ad4928fd5\",\"license\":\"BUSL-1.1\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"./ICommonOFT.sol\\\";\\n\\n/**\\n * @dev Interface of the IOFT core standard\\n */\\ninterface IOFTV2 is ICommonOFT {\\n\\n /**\\n * @dev send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from`\\n * `_from` the owner of token\\n * `_dstChainId` the destination chain identifier\\n * `_toAddress` can be any size depending on the `dstChainId`.\\n * `_amount` the quantity of tokens in wei\\n * `_refundAddress` the address LayerZero refunds if too much message fee is sent\\n * `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token)\\n * `_adapterParams` is a flexible bytes array to indicate messaging adapter services\\n */\\n function sendFrom(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, LzCallParams calldata _callParams) external payable;\\n\\n function sendAndCall(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, LzCallParams calldata _callParams) external payable;\\n}\\n\",\"keccak256\":\"0xb1d31f341715347d49db4e2c0de27c49bbd70b5b3d9b0adb1050b2b3a305ab87\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n _requireNotPaused();\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n _requirePaused();\\n _;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Throws if the contract is paused.\\n */\\n function _requireNotPaused() internal view virtual {\\n require(!paused(), \\\"Pausable: paused\\\");\\n }\\n\\n /**\\n * @dev Throws if the contract is not paused.\\n */\\n function _requirePaused() internal view virtual {\\n require(paused(), \\\"Pausable: not paused\\\");\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0x0849d93b16c9940beb286a7864ed02724b248b93e0d80ef6355af5ef15c64773\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xec63854014a5b4f2b3290ab9103a21bdf902a508d0f41a8573fea49e98bf571a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/ERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./IERC165.sol\\\";\\n\\n/**\\n * @dev Implementation of the {IERC165} interface.\\n *\\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\\n * for the additional interface id that will be supported. For example:\\n *\\n * ```solidity\\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\\n * }\\n * ```\\n *\\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\\n */\\nabstract contract ERC165 is IERC165 {\\n /**\\n * @dev See {IERC165-supportsInterface}.\\n */\\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\\n return interfaceId == type(IERC165).interfaceId;\\n }\\n}\\n\",\"keccak256\":\"0xd10975de010d89fd1c78dc5e8a9a7e7f496198085c151648f20cba166b32582b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\\n *\\n * Implementers can declare support of contract interfaces, which can then be\\n * queried by others ({ERC165Checker}).\\n *\\n * For an implementation, see {ERC165}.\\n */\\ninterface IERC165 {\\n /**\\n * @dev Returns true if this contract implements the interface defined by\\n * `interfaceId`. See the corresponding\\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\\n * to learn more about how these ids are created.\\n *\\n * This function call must use less than 30 000 gas.\\n */\\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x447a5f3ddc18419d41ff92b3773fb86471b1db25773e07f877f548918a185bf1\",\"license\":\"MIT\"},\"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\ninterface OracleInterface {\\n function getPrice(address asset) external view returns (uint256);\\n}\\n\\ninterface ResilientOracleInterface is OracleInterface {\\n function updatePrice(address vToken) external;\\n\\n function updateAssetPrice(address asset) external;\\n\\n function getUnderlyingPrice(address vToken) external view returns (uint256);\\n}\\n\\ninterface TwapInterface is OracleInterface {\\n function updateTwap(address asset) external returns (uint256);\\n}\\n\\ninterface BoundValidatorInterface {\\n function validatePriceWithAnchorPrice(\\n address asset,\\n uint256 reporterPrice,\\n uint256 anchorPrice\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x40031b19684ca0c912e794d08c2c0b0d8be77d3c1bdc937830a0658eff899650\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \\\"./constants.sol\\\";\\n\\n/**\\n * @title Exponential module for storing fixed-precision decimals\\n * @author Compound\\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\\n * `Exp({mantissa: 5100000000000000000})`.\\n */\\ncontract ExponentialNoError {\\n struct Exp {\\n uint256 mantissa;\\n }\\n\\n struct Double {\\n uint256 mantissa;\\n }\\n\\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\\n uint256 internal constant DOUBLE_SCALE = 1e36;\\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\\n\\n /**\\n * @dev Truncates the given exp to a whole number value.\\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\\n */\\n function truncate(Exp memory exp) internal pure returns (uint256) {\\n // Note: We are not using careful math here as we're performing a division that cannot fail\\n return exp.mantissa / EXP_SCALE;\\n }\\n\\n /**\\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\\n Exp memory product = mul_(a, scalar);\\n return truncate(product);\\n }\\n\\n /**\\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\\n Exp memory product = mul_(a, scalar);\\n return add_(truncate(product), addend);\\n }\\n\\n /**\\n * @dev Checks if first Exp is less than second Exp.\\n */\\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\\n return left.mantissa < right.mantissa;\\n }\\n\\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\\n require(n <= type(uint224).max, errorMessage);\\n return uint224(n);\\n }\\n\\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\\n require(n <= type(uint32).max, errorMessage);\\n return uint32(n);\\n }\\n\\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\\n }\\n\\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\\n }\\n\\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\\n }\\n\\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\\n }\\n\\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\\n }\\n\\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: mul_(a.mantissa, b) });\\n }\\n\\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\\n return mul_(a, b.mantissa) / EXP_SCALE;\\n }\\n\\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\\n }\\n\\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: mul_(a.mantissa, b) });\\n }\\n\\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\\n }\\n\\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\\n }\\n\\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: div_(a.mantissa, b) });\\n }\\n\\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\\n return div_(mul_(a, EXP_SCALE), b.mantissa);\\n }\\n\\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\\n }\\n\\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(a.mantissa, b) });\\n }\\n\\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\\n }\\n\\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\\n }\\n}\\n\",\"keccak256\":\"0x6cf5430c2db151ab24ef0f567ed443c0b75b8b6051a62cacbe83f28b16834605\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/constants.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\\nuint256 constant EXP_SCALE = 1e18;\\n\\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\\nuint256 constant MANTISSA_ONE = EXP_SCALE;\\n\",\"keccak256\":\"0x44de02d7837ee1d4dcf6e9f5e783e9d9e0bec0154f23f5661fb54810cff9f892\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0x909eb76841ebd57d8f53686b76b1a09da7bbbbcddb29510c41674d5aa84c713e\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/BaseXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { ResilientOracleInterface } from \\\"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\\\";\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { BaseOFTV2 } from \\\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { ExponentialNoError } from \\\"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\\\";\\n\\n/**\\n * @title BaseXVSProxyOFT\\n * @author Venus\\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\\n * It manages transaction limits of a single and daily transactions.\\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\\n */\\n\\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\\n using SafeERC20 for IERC20;\\n IERC20 internal immutable innerToken;\\n uint256 internal immutable ld2sdRate;\\n bool public sendAndCallEnabled;\\n\\n /**\\n * @notice The address of ResilientOracle contract wrapped in its interface.\\n */\\n ResilientOracleInterface public oracle;\\n /**\\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\\n /**\\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\\n /**\\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\\n /**\\n * @notice Timestamp when the last 24-hour window started from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\\n /**\\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\\n /**\\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\\n /**\\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\\n /**\\n * @notice Timestamp when the last 24-hour window started from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\\n /**\\n * @notice Address on which cap check and bound limit is not applicable.\\n */\\n mapping(address => bool) public whitelist;\\n\\n /**\\n * @notice Emitted when address is added to whitelist.\\n */\\n event SetWhitelist(address indexed addr, bool isWhitelist);\\n /**\\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\\n */\\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\\n */\\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\\n */\\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\\n */\\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Event emitted when oracle is modified.\\n */\\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\\n /**\\n * @notice Event emitted when trusted remote sets to empty.\\n */\\n event TrustedRemoteRemoved(uint16 chainId);\\n /**\\n * @notice Event emitted when inner token set successfully.\\n */\\n event InnerTokenAdded(address indexed innerToken);\\n /**\\n *@notice Emitted on sweep token success\\n */\\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\\n /**\\n * @notice Event emitted when SendAndCallEnabled updated successfully.\\n */\\n event UpdateSendAndCallEnabled(bool indexed enabled);\\n /**\\n *@notice Error thrown when this contract balance is less than sweep amount\\n */\\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\\n\\n /**\\n * @param tokenAddress_ Address of the inner token.\\n * @param sharedDecimals_ Number of shared decimals.\\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\\n * @param oracle_ Address of the price oracle.\\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\\n * @custom:event Emits InnerTokenAdded with token address.\\n * @custom:event Emits OracleChanged with zero address and oracle address.\\n */\\n constructor(\\n address tokenAddress_,\\n uint8 sharedDecimals_,\\n address lzEndpoint_,\\n address oracle_\\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\\n ensureNonzeroAddress(tokenAddress_);\\n ensureNonzeroAddress(lzEndpoint_);\\n ensureNonzeroAddress(oracle_);\\n\\n innerToken = IERC20(tokenAddress_);\\n\\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\\\"decimals()\\\"));\\n require(success, \\\"ProxyOFT: failed to get token decimals\\\");\\n uint8 decimals = abi.decode(data, (uint8));\\n\\n require(sharedDecimals_ <= decimals, \\\"ProxyOFT: sharedDecimals must be <= decimals\\\");\\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\\n\\n emit InnerTokenAdded(tokenAddress_);\\n emit OracleChanged(address(0), oracle_);\\n\\n oracle = ResilientOracleInterface(oracle_);\\n }\\n\\n /**\\n * @notice Set the address of the ResilientOracle contract.\\n * @dev Reverts if the new address is zero.\\n * @param oracleAddress_ The new address of the ResilientOracle contract.\\n * @custom:access Only owner.\\n * @custom:event Emits OracleChanged with old and new oracle address.\\n */\\n function setOracle(address oracleAddress_) external onlyOwner {\\n ensureNonzeroAddress(oracleAddress_);\\n emit OracleChanged(address(oracle), oracleAddress_);\\n oracle = ResilientOracleInterface(oracleAddress_);\\n }\\n\\n /**\\n * @notice Sets the limit of single transaction amount.\\n * @param chainId_ Destination chain id.\\n * @param limit_ Amount in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\\n */\\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \\\"Single transaction limit > Daily limit\\\");\\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the limit of daily (24 Hour) transactions amount.\\n * @param chainId_ Destination chain id.\\n * @param limit_ Amount in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\\n */\\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \\\"Daily limit < single transaction limit\\\");\\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\\n chainIdToMaxDailyLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the maximum limit for a single receive transaction.\\n * @param chainId_ The destination chain ID.\\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\\n */\\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \\\"single receive transaction limit > Daily limit\\\");\\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the maximum daily limit for receiving transactions.\\n * @param chainId_ The destination chain ID.\\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\\n */\\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(\\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\\n \\\"Daily limit < single receive transaction limit\\\"\\n );\\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the whitelist address to skip checks on transaction limit.\\n * @param user_ Address to be add in whitelist.\\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\\n * @custom:access Only owner.\\n * @custom:event Emits setWhitelist.\\n */\\n function setWhitelist(address user_, bool val_) external onlyOwner {\\n emit SetWhitelist(user_, val_);\\n whitelist[user_] = val_;\\n }\\n\\n /**\\n * @notice Triggers stopped state of the bridge.\\n * @custom:access Only owner.\\n */\\n function pause() external onlyOwner {\\n _pause();\\n }\\n\\n /**\\n * @notice Triggers resume state of the bridge.\\n * @custom:access Only owner.\\n */\\n function unpause() external onlyOwner {\\n _unpause();\\n }\\n\\n /**\\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\\n * @param token_ The address of the ERC-20 token to sweep\\n * @param to_ The address of the recipient\\n * @param amount_ The amount of tokens needs to transfer\\n * @custom:event Emits SweepToken event\\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\\n * @custom:access Only Owner\\n */\\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\\n uint256 balance = token_.balanceOf(address(this));\\n if (amount_ > balance) {\\n revert InsufficientBalance(amount_, balance);\\n }\\n\\n emit SweepToken(address(token_), to_, amount_);\\n\\n token_.safeTransfer(to_, amount_);\\n }\\n\\n /**\\n * @notice Remove trusted remote from storage.\\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\\n * @custom:access Only owner.\\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\\n */\\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\\n delete trustedRemoteLookup[remoteChainId_];\\n emit TrustedRemoteRemoved(remoteChainId_);\\n }\\n\\n /**\\n * @notice It enables or disables sendAndCall functionality for the bridge.\\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\\n */\\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\\n sendAndCallEnabled = enabled_;\\n emit UpdateSendAndCallEnabled(enabled_);\\n }\\n\\n /**\\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\\n * @param from_ The sender's address initiating the transfer.\\n * @param dstChainId_ Indicates destination chain.\\n * @param amount_ The quantity of tokens to be transferred.\\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\\n * @return maxDailyLimit The maximum daily limit for transactions.\\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\\n */\\n function isEligibleToSend(\\n address from_,\\n uint16 dstChainId_,\\n uint256 amount_\\n )\\n external\\n view\\n returns (\\n bool eligibleToSend,\\n uint256 maxSingleTransactionLimit,\\n uint256 maxDailyLimit,\\n uint256 amountInUsd,\\n uint256 transferredInWindow,\\n uint256 last24HourWindowStart,\\n bool isWhiteListedUser\\n )\\n {\\n // Check if the sender's address is whitelisted\\n isWhiteListedUser = whitelist[from_];\\n\\n // Calculate the amount in USD using the oracle price\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\\n\\n // Load values for the 24-hour window checks\\n uint256 currentBlockTimestamp = block.timestamp;\\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\\n transferredInWindow = amountInUsd;\\n last24HourWindowStart = currentBlockTimestamp;\\n } else {\\n transferredInWindow += amountInUsd;\\n }\\n eligibleToSend = (isWhiteListedUser ||\\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\\n }\\n\\n /**\\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\\n * @param from_ Address from which tokens will be debited.\\n * @param dstChainId_ Destination chain id on which tokens will be send.\\n * @param toAddress_ Address on which tokens will be credited on destination chain.\\n * @param amount_ Amount of tokens that will be transferred.\\n * @param payload_ Additional data payload for the call on the destination chain.\\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\\n * and adapter params.\\n */\\n function sendAndCall(\\n address from_,\\n uint16 dstChainId_,\\n bytes32 toAddress_,\\n uint256 amount_,\\n bytes calldata payload_,\\n uint64 dstGasForCall_,\\n LzCallParams calldata callparams_\\n ) public payable override {\\n require(sendAndCallEnabled, \\\"sendAndCall is disabled\\\");\\n\\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\\n }\\n\\n function retryMessage(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public payable override {\\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\\n require(\\n _srcAddress.length == trustedRemote.length &&\\n trustedRemote.length > 0 &&\\n keccak256(_srcAddress) == keccak256(trustedRemote),\\n \\\"LzApp: invalid source sending contract\\\"\\n );\\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @notice Return's the address of the inner token of this bridge.\\n * @return Address of the inner token of this bridge.\\n */\\n function token() public view override returns (address) {\\n return address(innerToken);\\n }\\n\\n /**\\n * @notice Checks if the sender is eligible to send tokens\\n * @param from_ Sender's address sending tokens\\n * @param dstChainId_ Chain id on which tokens should be sent\\n * @param amount_ Amount of tokens to be sent\\n */\\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\\n // Check if the sender's address is whitelisted\\n bool isWhiteListedUser = whitelist[from_];\\n // Check if the user is whitelisted and return if true\\n if (isWhiteListedUser) {\\n return;\\n }\\n\\n // Calculate the amount in USD using the oracle price\\n uint256 amountInUsd;\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\\n\\n // Load values for the 24-hour window checks\\n uint256 currentBlockTimestamp = block.timestamp;\\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\\n\\n // Revert if the amount exceeds the single transaction limit\\n require(amountInUsd <= maxSingleTransactionLimit, \\\"Single Transaction Limit Exceed\\\");\\n\\n // Check if the time window has changed (more than 24 hours have passed)\\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\\n transferredInWindow = amountInUsd;\\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\\n } else {\\n transferredInWindow += amountInUsd;\\n }\\n\\n // Revert if the amount exceeds the daily limit\\n require(transferredInWindow <= maxDailyLimit, \\\"Daily Transaction Limit Exceed\\\");\\n\\n // Update the amount for the 24-hour window\\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\\n }\\n\\n /**\\n * @notice Checks if receiver is able to receive tokens\\n * @param toAddress_ Receiver address\\n * @param srcChainId_ Source chain id from which token is send\\n * @param receivedAmount_ Amount of tokens received\\n */\\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\\n // Check if the recipient's address is whitelisted\\n bool isWhiteListedUser = whitelist[toAddress_];\\n // Check if the user is whitelisted and return if true\\n if (isWhiteListedUser) {\\n return;\\n }\\n\\n // Calculate the received amount in USD using the oracle price\\n uint256 receivedAmountInUsd;\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\\n\\n uint256 currentBlockTimestamp = block.timestamp;\\n\\n // Load values for the 24-hour window checks for receiving\\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\\n\\n // Check if the received amount exceeds the single transaction limit\\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \\\"Single Transaction Limit Exceed\\\");\\n\\n // Check if the time window has changed (more than 24 hours have passed)\\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\\n receivedInWindow = receivedAmountInUsd;\\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\\n } else {\\n receivedInWindow += receivedAmountInUsd;\\n }\\n\\n // Revert if the received amount exceeds the daily limit\\n require(receivedInWindow <= maxDailyReceiveLimit, \\\"Daily Transaction Limit Exceed\\\");\\n\\n // Update the received amount for the 24-hour window\\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\\n }\\n\\n /**\\n * @notice Transfer tokens from sender to receiver account.\\n * @param from_ Address from which token has to be transferred(Sender).\\n * @param to_ Address on which token will be tranferred(Receiver).\\n * @param amount_ Amount of token to be transferred.\\n * @return Actual balance difference.\\n */\\n function _transferFrom(\\n address from_,\\n address to_,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n uint256 before = innerToken.balanceOf(to_);\\n if (from_ == address(this)) {\\n innerToken.safeTransfer(to_, amount_);\\n } else {\\n innerToken.safeTransferFrom(from_, to_, amount_);\\n }\\n return innerToken.balanceOf(to_) - before;\\n }\\n\\n /**\\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\\n * @return Conversion rate factor.\\n */\\n function _ld2sdRate() internal view override returns (uint256) {\\n return ld2sdRate;\\n }\\n}\\n\",\"keccak256\":\"0x75d98574e674d1c3f35ac92c9e930d0238059b540d3385abeb14b20ef03cb13c\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSProxyOFTDest.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\nimport { IXVS } from \\\"./interfaces/IXVS.sol\\\";\\nimport { BaseXVSProxyOFT } from \\\"./BaseXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSProxyOFTDest\\n * @author Venus\\n * @notice XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT,\\n * and focuses on managing token transfers to the destination chain.\\n * It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\\n */\\n\\ncontract XVSProxyOFTDest is BaseXVSProxyOFT {\\n /**\\n * @notice Emits when stored message dropped without successful retrying.\\n */\\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\\n\\n constructor(\\n address tokenAddress_,\\n uint8 sharedDecimals_,\\n address lzEndpoint_,\\n address oracle_\\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\\n\\n /**\\n * @notice Clear failed messages from the storage.\\n * @param srcChainId_ Chain id of source\\n * @param srcAddress_ Address of source followed by current bridge address\\n * @param nonce_ Nonce_ of the transaction\\n * @custom:access Only owner\\n * @custom:event Emits DropFailedMessage on clearance of failed message.\\n */\\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\\n }\\n\\n /**\\n * @notice Returns the total circulating supply of the token on the destination chain i.e (total supply).\\n * @return total circulating supply of the token on the destination chain.\\n */\\n function circulatingSupply() public view override returns (uint256) {\\n return innerToken.totalSupply();\\n }\\n\\n /**\\n * @notice Debit tokens from the given address\\n * @param from_ Address from which tokens to be debited\\n * @param dstChainId_ Destination chain id\\n * @param amount_ Amount of tokens to be debited\\n * @return Actual amount debited\\n */\\n function _debitFrom(\\n address from_,\\n uint16 dstChainId_,\\n bytes32,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n require(from_ == _msgSender(), \\\"ProxyOFT: owner is not send caller\\\");\\n _isEligibleToSend(from_, dstChainId_, amount_);\\n IXVS(address(innerToken)).burn(from_, amount_);\\n return amount_;\\n }\\n\\n /**\\n * @notice Credit tokens in the given account\\n * @param srcChainId_ Source chain id\\n * @param toAddress_ Address on which token will be credited\\n * @param amount_ Amount of tokens to be credited\\n * @return Actual amount credited\\n */\\n function _creditTo(\\n uint16 srcChainId_,\\n address toAddress_,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\\n IXVS(address(innerToken)).mint(toAddress_, amount_);\\n return amount_;\\n }\\n}\\n\",\"keccak256\":\"0x4a4bf23d37f26b82877c24326d81699f0ca217a593599fa179d45db8be919e50\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVS.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.13;\\n\\n/**\\n * @title IXVS\\n * @author Venus\\n * @notice Interface implemented by `XVS` token.\\n */\\ninterface IXVS {\\n function mint(address to, uint256 amount) external;\\n\\n function burn(address from, uint256 amount) external;\\n}\\n\",\"keccak256\":\"0x55c954155c4499e8ef1915ad28c5567c247e4397dc12ba553b33c5edb1114dba\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", - "bytecode": "0x6101006040523480156200001257600080fd5b5060405162005adf38038062005adf833981016040819052620000359162000379565b6000805460ff19169055838383838282818180806200005433620002c6565b6001600160a01b0316608052505060ff1660a05250620000769050846200031f565b62000081826200031f565b6200008c816200031f565b6001600160a01b03841660c081905260408051600481526024810182526020810180516001600160e01b031663313ce56760e01b179052905160009283929091620000d89190620003d6565b600060405180830381855afa9150503d806000811462000115576040519150601f19603f3d011682016040523d82523d6000602084013e6200011a565b606091505b509150915081620001815760405162461bcd60e51b815260206004820152602660248201527f50726f78794f46543a206661696c656420746f2067657420746f6b656e20646560448201526563696d616c7360d01b60648201526084015b60405180910390fd5b60008180602001905181019062000199919062000414565b90508060ff168660ff161115620002085760405162461bcd60e51b815260206004820152602c60248201527f50726f78794f46543a20736861726564446563696d616c73206d75737420626560448201526b203c3d20646563696d616c7360a01b606482015260840162000178565b6200021486826200044f565b6200022190600a62000574565b60e0526040516001600160a01b038816907f0b673f021ff9a27bbe58f282908695869e130b3103029190387b83650806c2c390600090a26040516001600160a01b038516906000907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd908290a35050600780546001600160a01b0390931661010002610100600160a81b03199093169290921790915550620005859650505050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6001600160a01b03811662000347576040516342bcdf7f60e11b815260040160405180910390fd5b50565b80516001600160a01b03811681146200036257600080fd5b919050565b805160ff811681146200036257600080fd5b600080600080608085870312156200039057600080fd5b6200039b856200034a565b9350620003ab6020860162000367565b9250620003bb604086016200034a565b9150620003cb606086016200034a565b905092959194509250565b6000825160005b81811015620003f95760208186018101518583015201620003dd565b8181111562000409576000828501525b509190910192915050565b6000602082840312156200042757600080fd5b620004328262000367565b9392505050565b634e487b7160e01b600052601160045260246000fd5b600060ff821660ff8416808210156200046c576200046c62000439565b90039392505050565b600181815b80851115620004b65781600019048211156200049a576200049a62000439565b80851615620004a857918102915b93841c93908002906200047a565b509250929050565b600082620004cf575060016200056e565b81620004de575060006200056e565b8160018114620004f75760028114620005025762000522565b60019150506200056e565b60ff84111562000516576200051662000439565b50506001821b6200056e565b5060208310610133831016604e8410600b841016171562000547575081810a6200056e565b62000553838362000475565b80600019048211156200056a576200056a62000439565b0290505b92915050565b60006200043260ff841683620004be565b60805160a05160c05160e05161548d62000652600039600081816130d4015281816136470152613b82015260008181610ca10152818161106801528181611ba701528181612d7501528181612e0101528181612e3a01528181612e830152818161371d01528181613beb01528181613db401526141e4015260006108be015260008181610abe01528181610cf501528181610f3c01528181610fe40152818161142601528181611ed9015281816123cc015281816125a701528181612aa501526138ab015261548d6000f3fe6080604052600436106103b75760003560e01c80637dc0d1d0116101f2578063baf3292d1161010d578063df2a5b3b116100a0578063f2fde38b1161006f578063f2fde38b14610c52578063f5ecbdbc14610c72578063fc0c546a14610c92578063fdff235b14610cc557600080fd5b8063df2a5b3b14610bdd578063e6a20ae614610bfd578063eaffd49a14610c12578063eb8d72b714610c3257600080fd5b8063cc01e9b6116100dc578063cc01e9b614610b50578063cc7015ae14610b70578063d1deba1f14610b9d578063d708a46814610bb057600080fd5b8063baf3292d14610ae0578063c1e9132e14610b00578063c446183414610b1a578063cbed8b9c14610b3057600080fd5b806393a61d6c116101855780639f38369a116101545780639f38369a14610a4c578063a4c51df514610a6c578063a6c3d16514610a8c578063b353aaa714610aac57600080fd5b806393a61d6c1461097d578063950c8a74146109aa5780639b19251a146109ca5780639bdb9812146109fa57600080fd5b80638cfd8f5c116101c15780638cfd8f5c146108e05780638da5cb5b14610918578063904365671461093b5780639358928b1461096857600080fd5b80637dc0d1d01461083a5780638456cb591461087757806384e69c691461088c578063857749b0146108ac57600080fd5b80634c42899a116102e257806364aff9ec11610275578063715018a611610244578063715018a6146107ce5780637533d788146107da57806376203b48146108075780637adbf9731461081a57600080fd5b806364aff9ec1461075b57806366ad5c8a1461077b578063695ef6bf1461079b57806369c1e7b8146107ae57600080fd5b806353489d6c116102b157806353489d6c146106b457806353d6fd59146106d45780635b8c41e6146106f45780635c975abb1461074357600080fd5b80634c42899a146106135780634cec62561461063a5780634ed2c662146106675780634f4ba0f41461068757600080fd5b80632dbbec081161035a5780633f1f4fa4116103295780633f1f4fa41461059c5780633f4ba83a146105c957806342d65a8d146105de57806344770515146105fe57600080fd5b80632dbbec08146104ec578063365260b41461050c5780633c4ec39b146105415780633d8b38f61461057c57600080fd5b80630df37483116103965780630df374831461043357806310ddb13714610453578063182b4b89146104735780632488eec8146104cc57600080fd5b80621d3567146103bc57806301ffc9a7146103de57806307e0db1714610413575b600080fd5b3480156103c857600080fd5b506103dc6103d736600461466d565b610cf2565b005b3480156103ea57600080fd5b506103fe6103f9366004614700565b610ee4565b60405190151581526020015b60405180910390f35b34801561041f57600080fd5b506103dc61042e36600461472a565b610f1b565b34801561043f57600080fd5b506103dc61044e366004614745565b610fa4565b34801561045f57600080fd5b506103dc61046e36600461472a565b610fc3565b34801561047f57600080fd5b5061049361048e366004614784565b61101b565b6040805197151588526020880196909652948601939093526060850191909152608084015260a0830152151560c082015260e00161040a565b3480156104d857600080fd5b506103dc6104e7366004614745565b611191565b3480156104f857600080fd5b506103dc61050736600461472a565b611275565b34801561051857600080fd5b5061052c6105273660046147d0565b6112d4565b6040805192835260208301919091520161040a565b34801561054d57600080fd5b5061056e61055c36600461472a565b600d6020526000908152604090205481565b60405190815260200161040a565b34801561058857600080fd5b506103fe610597366004614837565b611329565b3480156105a857600080fd5b5061056e6105b736600461472a565b60036020526000908152604090205481565b3480156105d557600080fd5b506103dc6113f5565b3480156105ea57600080fd5b506103dc6105f9366004614837565b611407565b34801561060a57600080fd5b5061056e600081565b34801561061f57600080fd5b50610628600081565b60405160ff909116815260200161040a565b34801561064657600080fd5b5061056e61065536600461472a565b600a6020526000908152604090205481565b34801561067357600080fd5b506103dc610682366004614889565b61148d565b34801561069357600080fd5b5061056e6106a236600461472a565b60096020526000908152604090205481565b3480156106c057600080fd5b506103dc6106cf366004614745565b6114d2565b3480156106e057600080fd5b506103dc6106ef3660046148a6565b6115b6565b34801561070057600080fd5b5061056e61070f36600461494c565b6005602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205481565b34801561074f57600080fd5b5060005460ff166103fe565b34801561076757600080fd5b506103dc6107763660046149ec565b61162e565b34801561078757600080fd5b506103dc61079636600461466d565b611735565b6103dc6107a9366004614a45565b611811565b3480156107ba57600080fd5b506103dc6107c9366004614745565b61187c565b3480156103dc57600080fd5b3480156107e657600080fd5b506107fa6107f536600461472a565b611968565b60405161040a9190614b10565b6103dc610815366004614b23565b611a02565b34801561082657600080fd5b506103dc610835366004614bd5565b611a6e565b34801561084657600080fd5b5060075461085f9061010090046001600160a01b031681565b6040516001600160a01b03909116815260200161040a565b34801561088357600080fd5b506103dc611ae6565b34801561089857600080fd5b506103dc6108a736600461494c565b611af6565b3480156108b857600080fd5b506106287f000000000000000000000000000000000000000000000000000000000000000081565b3480156108ec57600080fd5b5061056e6108fb366004614bf2565b600260209081526000928352604080842090915290825290205481565b34801561092457600080fd5b5060005461010090046001600160a01b031661085f565b34801561094757600080fd5b5061056e61095636600461472a565b600c6020526000908152604090205481565b34801561097457600080fd5b5061056e611ba3565b34801561098957600080fd5b5061056e61099836600461472a565b600b6020526000908152604090205481565b3480156109b657600080fd5b5060045461085f906001600160a01b031681565b3480156109d657600080fd5b506103fe6109e5366004614bd5565b60106020526000908152604090205460ff1681565b348015610a0657600080fd5b506103fe610a1536600461494c565b6006602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205460ff1681565b348015610a5857600080fd5b506107fa610a6736600461472a565b611c2c565b348015610a7857600080fd5b5061052c610a87366004614c25565b611d42565b348015610a9857600080fd5b506103dc610aa7366004614837565b611dd1565b348015610ab857600080fd5b5061085f7f000000000000000000000000000000000000000000000000000000000000000081565b348015610aec57600080fd5b506103dc610afb366004614bd5565b611e64565b348015610b0c57600080fd5b506007546103fe9060ff1681565b348015610b2657600080fd5b5061056e61271081565b348015610b3c57600080fd5b506103dc610b4b366004614ce2565b611eba565b348015610b5c57600080fd5b506103dc610b6b366004614745565b611f4f565b348015610b7c57600080fd5b5061056e610b8b36600461472a565b60086020526000908152604090205481565b6103dc610bab36600461466d565b61203b565b348015610bbc57600080fd5b5061056e610bcb36600461472a565b600e6020526000908152604090205481565b348015610be957600080fd5b506103dc610bf8366004614d50565b61213f565b348015610c0957600080fd5b50610628600181565b348015610c1e57600080fd5b506103dc610c2d366004614d6e565b6121a9565b348015610c3e57600080fd5b506103dc610c4d366004614837565b6122c8565b348015610c5e57600080fd5b506103dc610c6d366004614bd5565b612322565b348015610c7e57600080fd5b506107fa610c8d366004614e36565b61239b565b348015610c9e57600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061085f565b348015610cd157600080fd5b5061056e610ce036600461472a565b600f6020526000908152604090205481565b337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031614610d6f5760405162461bcd60e51b815260206004820152601e60248201527f4c7a4170703a20696e76616c696420656e64706f696e742063616c6c6572000060448201526064015b60405180910390fd5b61ffff861660009081526001602052604081208054610d8d90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054610db990614e83565b8015610e065780601f10610ddb57610100808354040283529160200191610e06565b820191906000526020600020905b815481529060010190602001808311610de957829003601f168201915b50505050509050805186869050148015610e21575060008151115b8015610e49575080516020820120604051610e3f9088908890614eb7565b6040518091039020145b610e655760405162461bcd60e51b8152600401610d6690614ec7565b610edb8787878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8a018190048102820181019092528881528a93509150889088908190840183828082843760009201919091525061244e92505050565b50505050505050565b60006001600160e01b03198216631f7ecdf760e01b1480610f1557506301ffc9a760e01b6001600160e01b03198316145b92915050565b610f236124c7565b6040516307e0db1760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906307e0db17906024015b600060405180830381600087803b158015610f8957600080fd5b505af1158015610f9d573d6000803e3d6000fd5b5050505050565b610fac6124c7565b61ffff909116600090815260036020526040902055565b610fcb6124c7565b6040516310ddb13760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906310ddb13790602401610f6f565b6001600160a01b03838116600090815260106020908152604080832054815192830190915260075492938493849384938493849360ff909216928492909182916101009004166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156110cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110ef9190614f0d565b905290506110fd818a612527565b61ffff8b166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054919a509098509196509094509250426201518061114b8583614f3c565b111561115c57859450809350611169565b6111668686614f53565b94505b828061118057508786111580156111805750868511155b985050509397509397509397909450565b6111996124c7565b61ffff821660009081526008602052604090205481101561120b5760405162461bcd60e51b815260206004820152602660248201527f4461696c79206c696d6974203c2073696e676c65207472616e73616374696f6e604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600960209081526040918290205482519384529083015281018290527f4dd31065e259d5284e44d1f9265710da72eafcf78dc925e3881189fc3b71f6939060600160405180910390a161ffff909116600090815260096020526040902055565b61127d6124c7565b61ffff81166000908152600160205260408120611299916144b0565b60405161ffff821681527f6d5075c81d4d9e75bec6052f4e44f58f8a8cf1327544addbbf015fb06f83bd37906020015b60405180910390a150565b60008061131a8888888888888080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061253f92505050565b91509150965096945050505050565b61ffff83166000908152600160205260408120805482919061134a90614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461137690614e83565b80156113c35780601f10611398576101008083540402835291602001916113c3565b820191906000526020600020905b8154815290600101906020018083116113a657829003601f168201915b5050505050905083836040516113da929190614eb7565b60405180910390208180519060200120149150509392505050565b6113fd6124c7565b611405612633565b565b61140f6124c7565b6040516342d65a8d60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906342d65a8d9061145f90869086908690600401614f94565b600060405180830381600087803b15801561147957600080fd5b505af1158015610edb573d6000803e3d6000fd5b6114956124c7565b6007805460ff19168215159081179091556040517fe628f01c6f4e6340598d3a2913390db68e8859379eebff349e170f2b16baed0090600090a250565b6114da6124c7565b61ffff821660009081526009602052604090205481111561154c5760405162461bcd60e51b815260206004820152602660248201527f53696e676c65207472616e73616374696f6e206c696d6974203e204461696c79604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600860209081526040918290205482519384529083015281018290527f7babeac42ccbb33537ee421fedc4db7b5f251b5d2a3fa5c0ff4b35b2d783be879060600160405180910390a161ffff909116600090815260086020526040902055565b6115be6124c7565b816001600160a01b03167ff6019ec0a78d156d249a1ec7579e2321f6ac7521d6e1d2eacf90ba4a184dcceb826040516115fb911515815260200190565b60405180910390a26001600160a01b03919091166000908152601060205260409020805460ff1916911515919091179055565b6116366124c7565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a0823190602401602060405180830381865afa15801561167d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a19190614f0d565b9050808211156116ce5760405163cf47918160e01b81526004810183905260248101829052604401610d66565b826001600160a01b0316846001600160a01b03167f6d25be279134f4ecaa4770aff0c3d916d9e7c5ef37b65ed95dbdba411f5d54d58460405161171391815260200190565b60405180910390a361172f6001600160a01b0385168484612685565b50505050565b3330146117935760405162461bcd60e51b815260206004820152602660248201527f4e6f6e626c6f636b696e674c7a4170703a2063616c6c6572206d7573742062656044820152650204c7a4170760d41b6064820152608401610d66565b6118098686868080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8901819004810282018101909252878152899350915087908790819084018382808284376000920191909152506126ed92505050565b505050505050565b611809858585856118256020870187614bd5565b6118356040880160208901614bd5565b6118426040890189614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061277492505050565b6118846124c7565b61ffff82166000908152600c60205260409020548110156118fe5760405162461bcd60e51b815260206004820152602e60248201527f4461696c79206c696d6974203c2073696e676c6520726563656976652074726160448201526d1b9cd858dd1a5bdb881b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600d60209081526040918290205482519384529083015281018290527f95dc51094cd27cf4ee3fd0dbb50cf96f8df1629c822f5434c4a34d7eb03c97249060600160405180910390a161ffff9091166000908152600d6020526040902055565b6001602052600090815260409020805461198190614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90614e83565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b505050505081565b60075460ff16611a545760405162461bcd60e51b815260206004820152601760248201527f73656e64416e6443616c6c2069732064697361626c65640000000000000000006044820152606401610d66565b611a64888888888888888861285c565b5050505050505050565b611a766124c7565b611a7f81612900565b6007546040516001600160a01b0380841692610100900416907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd90600090a3600780546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b611aee6124c7565b611405612927565b611afe6124c7565b61ffff83166000908152600560205260408082209051611b1f908590614ff8565b9081526040805191829003602090810183206001600160401b038616600090815291522091909155611b52908390614ff8565b6040805191829003822061ffff861683526001600160401b0384166020840152917f48a980eea4ea1c540209e2f9f32a4c2edf51fab37b1d21f453868301ecb6e2ee910160405180910390a2505050565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c03573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c279190614f0d565b905090565b61ffff8116600090815260016020526040812080546060929190611c4f90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054611c7b90614e83565b8015611cc85780601f10611c9d57610100808354040283529160200191611cc8565b820191906000526020600020905b815481529060010190602001808311611cab57829003601f168201915b505050505090508051600003611d205760405162461bcd60e51b815260206004820152601d60248201527f4c7a4170703a206e6f20747275737465642070617468207265636f72640000006044820152606401610d66565b611d3b600060148351611d339190614f3c565b839190612964565b9392505050565b600080611dbf8b8b8b8b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b81528e93508d9250908c908c9081908401838280828437600092019190915250612a7192505050565b91509150995099975050505050505050565b611dd96124c7565b818130604051602001611dee93929190615014565b60408051601f1981840301815291815261ffff85166000908152600160209081529190208251611e23939192909101906144ea565b507f8c0400cfe2d1199b1a725c78960bcc2a344d869b80590d0f2bd005db15a572ce838383604051611e5793929190614f94565b60405180910390a1505050565b611e6c6124c7565b600480546001600160a01b0319166001600160a01b0383169081179091556040519081527f5db758e995a17ec1ad84bdef7e8c3293a0bd6179bcce400dff5d4c3d87db726b906020016112c9565b611ec26124c7565b6040516332fb62e760e21b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cbed8b9c90611f16908890889088908890889060040161503a565b600060405180830381600087803b158015611f3057600080fd5b505af1158015611f44573d6000803e3d6000fd5b505050505050505050565b611f576124c7565b61ffff82166000908152600d6020526040902054811115611fd15760405162461bcd60e51b815260206004820152602e60248201527f73696e676c652072656365697665207472616e73616374696f6e206c696d697460448201526d080f8811185a5b1e481b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600c60209081526040918290205482519384529083015281018290527f2c42997a938a029910a78e7c28d762b349c28e70f3a89c1fbccbb1a46020b1599060600160405180910390a161ffff9091166000908152600c6020526040902055565b61ffff86166000908152600160205260408120805461205990614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461208590614e83565b80156120d25780601f106120a7576101008083540402835291602001916120d2565b820191906000526020600020905b8154815290600101906020018083116120b557829003601f168201915b505050505090508051868690501480156120ed575060008151115b801561211557508051602082012060405161210b9088908890614eb7565b6040518091039020145b6121315760405162461bcd60e51b8152600401610d6690614ec7565b610edb878787878787612b33565b6121476124c7565b61ffff83811660008181526002602090815260408083209487168084529482529182902085905581519283528201929092529081018290527f9d5c7c0b934da8fefa9c7760c98383778a12dfbfc0c3b3106518f43fb9508ac090606001611e57565b3330146121f85760405162461bcd60e51b815260206004820152601f60248201527f4f4654436f72653a2063616c6c6572206d757374206265204f4654436f7265006044820152606401610d66565b612203308686612d49565b9350846001600160a01b03168a61ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8660405161224591815260200190565b60405180910390a3604051633fe79aed60e11b81526001600160a01b03861690637fcf35da908390612289908e908e908e908e908e908d908d908d90600401615068565b600060405180830381600088803b1580156122a357600080fd5b5087f11580156122b7573d6000803e3d6000fd5b505050505050505050505050505050565b6122d06124c7565b61ffff831660009081526001602052604090206122ee90838361456e565b507ffa41487ad5d6728f0b19276fa1eddc16558578f5109fc39d2dc33c3230470dab838383604051611e5793929190614f94565b61232a6124c7565b6001600160a01b03811661238f5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d66565b61239881612f03565b50565b604051633d7b2f6f60e21b815261ffff808616600483015284166024820152306044820152606481018290526060907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03169063f5ecbdbc90608401600060405180830381865afa15801561241b573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261244391908101906150c3565b90505b949350505050565b6000806124b15a60966366ad5c8a60e01b898989896040516024016124769493929190615130565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915230929190612f5c565b9150915081611809576118098686868685612fe6565b6000546001600160a01b036101009091041633146114055760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d66565b6000806125348484613083565b9050612446816130b4565b600080600061258d87612551886130cc565b6040805160006020820152602181019390935260c09190911b6001600160c01b0319166041830152805160298184030181526049909201905290565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb10906125e4908b90309086908b908b9060040161516e565b6040805180830381865afa158015612600573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061262491906151c2565b92509250509550959350505050565b61263b613152565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6040516001600160a01b0383166024820152604481018290526126e890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261319b565b505050565b60006126f98282613270565b905060ff81166127145761270f858585856132cc565b610f9d565b60001960ff82160161272c5761270f8585858561335c565b60405162461bcd60e51b815260206004820152601c60248201527f4f4654436f72653a20756e6b6e6f776e207061636b65742074797065000000006044820152606401610d66565b60006127828782848161356a565b61278b8561363f565b50905061279a8888888461367f565b9050600081116127e85760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006127f787612551846130cc565b9050612807888287878734613782565b86896001600160a01b03168961ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a8560405161284891815260200190565b60405180910390a450979650505050505050565b611f448888888888888080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a92506128a99150506020890189614bd5565b6128b960408a0160208b01614bd5565b6128c660408b018b614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061392792505050565b6001600160a01b038116612398576040516342bcdf7f60e11b815260040160405180910390fd5b61292f613a1c565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586126683390565b60608161297281601f614f53565b10156129b15760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b6044820152606401610d66565b6129bb8284614f53565b845110156129ff5760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b6044820152606401610d66565b606082158015612a1e5760405191506000825260208201604052612a68565b6040519150601f8416801560200281840101858101878315602002848b0101015b81831015612a57578051835260209283019201612a3f565b5050858452601f01601f1916604052505b50949350505050565b6000806000612a8b338a612a848b6130cc565b8a8a613a62565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb1090612ae2908d90309086908b908b9060040161516e565b6040805180830381865afa158015612afe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b2291906151c2565b925092505097509795505050505050565b61ffff86166000908152600560205260408082209051612b569088908890614eb7565b90815260408051602092819003830190206001600160401b03871660009081529252902054905080612bd65760405162461bcd60e51b815260206004820152602360248201527f4e6f6e626c6f636b696e674c7a4170703a206e6f2073746f726564206d65737360448201526261676560e81b6064820152608401610d66565b808383604051612be7929190614eb7565b604051809103902014612c465760405162461bcd60e51b815260206004820152602160248201527f4e6f6e626c6f636b696e674c7a4170703a20696e76616c6964207061796c6f616044820152601960fa1b6064820152608401610d66565b61ffff87166000908152600560205260408082209051612c699089908990614eb7565b90815260408051602092819003830181206001600160401b038916600090815290845282902093909355601f88018290048202830182019052868252612d01918991899089908190840183828082843760009201919091525050604080516020601f8a018190048102820181019092528881528a9350915088908890819084018382808284376000920191909152506126ed92505050565b7fc264d91f3adc5588250e1551f547752ca0cfa8f6b530d243b9f9f4cab10ea8e58787878785604051612d389594939291906151e6565b60405180910390a150505050505050565b6000612d53613a1c565b6040516370a0823160e01b81526001600160a01b0384811660048301526000917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612dbe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612de29190614f0d565b9050306001600160a01b03861603612e2d57612e286001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168585612685565b612e62565b612e626001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016868686613aa3565b6040516370a0823160e01b81526001600160a01b03858116600483015282917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612ecc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612ef09190614f0d565b612efa9190614f3c565b95945050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6000606060008060008661ffff166001600160401b03811115612f8157612f816148df565b6040519080825280601f01601f191660200182016040528015612fab576020820181803683370190505b50905060008087516020890160008d8df191503d925086831115612fcd578692505b828152826000602083013e909890975095505050505050565b8180519060200120600560008761ffff1661ffff168152602001908152602001600020856040516130179190614ff8565b9081526040805191829003602090810183206001600160401b0388166000908152915220919091557fe183f33de2837795525b4792ca4cd60535bd77c53b7e7030060bfcf5734d6b0c906130749087908790879087908790615221565b60405180910390a15050505050565b60408051602081019091526000815260405180602001604052806130ab856000015185613adb565b90529392505050565b8051600090610f1590670de0b6b3a764000090615289565b6000806130f97f000000000000000000000000000000000000000000000000000000000000000084615289565b90506001600160401b03811115610f155760405162461bcd60e51b815260206004820152601a60248201527f4f4654436f72653a20616d6f756e745344206f766572666c6f770000000000006044820152606401610d66565b60005460ff166114055760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610d66565b60006131f0826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316613ae79092919063ffffffff16565b9050805160001480613211575080806020019051810190613211919061529d565b6126e85760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610d66565b600061327d826001614f53565b835110156132c35760405162461bcd60e51b8152602060048201526013602482015272746f55696e74385f6f75744f66426f756e647360681b6044820152606401610d66565b50016001015190565b6000806132d883613af6565b90925090506001600160a01b0382166132f15761dead91505b60006132fc82613b7b565b9050613309878483613bb0565b9050826001600160a01b03168761ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8360405161334b91815260200190565b60405180910390a350505050505050565b600080600080600061336d86613c4f565b945094509450945094506000600660008b61ffff1661ffff168152602001908152602001600020896040516133a29190614ff8565b90815260408051602092819003830190206001600160401b038b166000908152925281205460ff1691506133d585613b7b565b905081613443576133e78b3083613bb0565b61ffff8c1660009081526006602052604090819020905191925060019161340f908d90614ff8565b90815260408051602092819003830190206001600160401b038d16600090815292529020805460ff19169115159190911790555b6001600160a01b0386163b61349a576040516001600160a01b03871681527f9aedf5fdba8716db3b6705ca00150643309995d4f818a249ed6dde6677e7792d9060200160405180910390a15050505050505061172f565b8a8a8a8a8a8a868a60008a6134b8578b6001600160401b03166134ba565b5a5b90506000806134ec5a609663eaffd49a60e01b8e8e8e8d8d8d8d8d6040516024016124769897969594939291906152ba565b915091508115613545578751602089012060405161ffff8d16907fb8890edbfc1c74692f527444645f95489c3703cc2df42e4a366f5d06fa6cd88490613537908e908e90869061532e565b60405180910390a250613552565b6135528b8b8b8b85612fe6565b50505050505050505050505050505050505050505050565b600061357583613d06565b61ffff808716600090815260026020908152604080832093891683529290522054909150806135e65760405162461bcd60e51b815260206004820152601a60248201527f4c7a4170703a206d696e4761734c696d6974206e6f74207365740000000000006044820152606401610d66565b6135f08382614f53565b8210156118095760405162461bcd60e51b815260206004820152601b60248201527f4c7a4170703a20676173206c696d697420697320746f6f206c6f7700000000006044820152606401610d66565b60008061366c7f00000000000000000000000000000000000000000000000000000000000000008461535c565b90506136788184614f3c565b9150915091565b6000613689613a1c565b6001600160a01b03851633146136ec5760405162461bcd60e51b815260206004820152602260248201527f50726f78794f46543a206f776e6572206973206e6f742073656e642063616c6c60448201526132b960f11b6064820152608401610d66565b6136f7858584613d62565b604051632770a7eb60e21b81526001600160a01b038681166004830152602482018490527f00000000000000000000000000000000000000000000000000000000000000001690639dc29fac90604401600060405180830381600087803b15801561376157600080fd5b505af1158015613775573d6000803e3d6000fd5b5093979650505050505050565b61ffff8616600090815260016020526040812080546137a090614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546137cc90614e83565b80156138195780601f106137ee57610100808354040283529160200191613819565b820191906000526020600020905b8154815290600101906020018083116137fc57829003601f168201915b50505050509050805160000361388a5760405162461bcd60e51b815260206004820152603060248201527f4c7a4170703a2064657374696e6174696f6e20636861696e206973206e6f742060448201526f61207472757374656420736f7572636560801b6064820152608401610d66565b613895878751613f84565b60405162c5803160e81b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063c58031009084906138ec908b9086908c908c908c908c90600401615370565b6000604051808303818588803b15801561390557600080fd5b505af1158015613919573d6000803e3d6000fd5b505050505050505050505050565b600061393f896001846001600160401b03891661356a565b6139488761363f565b5090506139578a8a8a8461367f565b9050600081116139a55760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006139b5338a612a84856130cc565b90506139c58a8287878734613782565b888b6001600160a01b03168b61ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a85604051613a0691815260200190565b60405180910390a4509998505050505050505050565b60005460ff16156114055760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610d66565b6060600185856001600160a01b0389168587604051602001613a89969594939291906153d7565b604051602081830303815290604052905095945050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261172f9085906323b872dd60e01b906084016126b1565b6000611d3b8284615438565b60606124468484600085613ff5565b60008080613b048482613270565b60ff16148015613b15575082516029145b613b5c5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613b6783600d6140d0565b9150613b74836021614135565b9050915091565b6000610f157f00000000000000000000000000000000000000000000000000000000000000006001600160401b038416615438565b6000613bba613a1c565b613bc5838584614192565b6040516340c10f1960e01b81526001600160a01b038481166004830152602482018490527f000000000000000000000000000000000000000000000000000000000000000016906340c10f1990604401600060405180830381600087803b158015613c2f57600080fd5b505af1158015613c43573d6000803e3d6000fd5b50939695505050505050565b600080806060816001613c628783613270565b60ff1614613cad5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613cb886600d6140d0565b9350613cc5866021614135565b9250613cd28660296143b4565b9450613cdf866049614135565b9050613cfb6051808851613cf39190614f3c565b889190612964565b915091939590929450565b6000602282511015613d5a5760405162461bcd60e51b815260206004820152601c60248201527f4c7a4170703a20696e76616c69642061646170746572506172616d73000000006044820152606401610d66565b506022015190565b6001600160a01b03831660009081526010602052604090205460ff168015613d8a5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015613e17573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e3b9190614f0d565b90529050613e498185612527565b61ffff86166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054939550429390919081871115613ed25760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b62015180613ee08587614f3c565b1115613f045761ffff8a166000908152600b60205260409020859055869250613f11565b613f0e8784614f53565b92505b80831115613f615760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600a602052604090209690965550505050505050565b61ffff821660009081526003602052604081205490819003613fa557506127105b808211156126e85760405162461bcd60e51b815260206004820181905260248201527f4c7a4170703a207061796c6f61642073697a6520697320746f6f206c617267656044820152606401610d66565b6060824710156140565760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610d66565b600080866001600160a01b031685876040516140729190614ff8565b60006040518083038185875af1925050503d80600081146140af576040519150601f19603f3d011682016040523d82523d6000602084013e6140b4565b606091505b50915091506140c587838387614412565b979650505050505050565b60006140dd826014614f53565b835110156141255760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b6044820152606401610d66565b500160200151600160601b900490565b6000614142826008614f53565b835110156141895760405162461bcd60e51b8152602060048201526014602482015273746f55696e7436345f6f75744f66426f756e647360601b6044820152606401610d66565b50016008015190565b6001600160a01b03831660009081526010602052604090205460ff1680156141ba5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015614247573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061426b9190614f0d565b905290506142798185612527565b61ffff86166000908152600f6020908152604080832054600e835281842054600c845282852054600d90945291909320549395504293909190818711156143025760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b620151806143108587614f3c565b11156143345761ffff8a166000908152600f60205260409020859055869250614341565b61433e8784614f53565b92505b808311156143915760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600e602052604090209690965550505050505050565b60006143c1826020614f53565b835110156144095760405162461bcd60e51b8152602060048201526015602482015274746f427974657333325f6f75744f66426f756e647360581b6044820152606401610d66565b50016020015190565b6060831561448157825160000361447a576001600160a01b0385163b61447a5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610d66565b5081612446565b61244683838151156144965781518083602001fd5b8060405162461bcd60e51b8152600401610d669190614b10565b5080546144bc90614e83565b6000825580601f106144cc575050565b601f01602090049060005260206000209081019061239891906145e2565b8280546144f690614e83565b90600052602060002090601f016020900481019282614518576000855561455e565b82601f1061453157805160ff191683800117855561455e565b8280016001018555821561455e579182015b8281111561455e578251825591602001919060010190614543565b5061456a9291506145e2565b5090565b82805461457a90614e83565b90600052602060002090601f01602090048101928261459c576000855561455e565b82601f106145b55782800160ff1982351617855561455e565b8280016001018555821561455e579182015b8281111561455e5782358255916020019190600101906145c7565b5b8082111561456a57600081556001016145e3565b803561ffff8116811461460957600080fd5b919050565b60008083601f84011261462057600080fd5b5081356001600160401b0381111561463757600080fd5b60208301915083602082850101111561464f57600080fd5b9250929050565b80356001600160401b038116811461460957600080fd5b6000806000806000806080878903121561468657600080fd5b61468f876145f7565b955060208701356001600160401b03808211156146ab57600080fd5b6146b78a838b0161460e565b90975095508591506146cb60408a01614656565b945060608901359150808211156146e157600080fd5b506146ee89828a0161460e565b979a9699509497509295939492505050565b60006020828403121561471257600080fd5b81356001600160e01b031981168114611d3b57600080fd5b60006020828403121561473c57600080fd5b611d3b826145f7565b6000806040838503121561475857600080fd5b614761836145f7565b946020939093013593505050565b6001600160a01b038116811461239857600080fd5b60008060006060848603121561479957600080fd5b83356147a48161476f565b92506147b2602085016145f7565b9150604084013590509250925092565b801515811461239857600080fd5b60008060008060008060a087890312156147e957600080fd5b6147f2876145f7565b955060208701359450604087013593506060870135614810816147c2565b925060808701356001600160401b0381111561482b57600080fd5b6146ee89828a0161460e565b60008060006040848603121561484c57600080fd5b614855846145f7565b925060208401356001600160401b0381111561487057600080fd5b61487c8682870161460e565b9497909650939450505050565b60006020828403121561489b57600080fd5b8135611d3b816147c2565b600080604083850312156148b957600080fd5b82356148c48161476f565b915060208301356148d4816147c2565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561491d5761491d6148df565b604052919050565b60006001600160401b0382111561493e5761493e6148df565b50601f01601f191660200190565b60008060006060848603121561496157600080fd5b61496a846145f7565b925060208401356001600160401b0381111561498557600080fd5b8401601f8101861361499657600080fd5b80356149a96149a482614925565b6148f5565b8181528760208385010111156149be57600080fd5b816020840160208301376000602083830101528094505050506149e360408501614656565b90509250925092565b600080600060608486031215614a0157600080fd5b8335614a0c8161476f565b92506020840135614a1c8161476f565b929592945050506040919091013590565b600060608284031215614a3f57600080fd5b50919050565b600080600080600060a08688031215614a5d57600080fd5b8535614a688161476f565b9450614a76602087016145f7565b9350604086013592506060860135915060808601356001600160401b03811115614a9f57600080fd5b614aab88828901614a2d565b9150509295509295909350565b60005b83811015614ad3578181015183820152602001614abb565b8381111561172f5750506000910152565b60008151808452614afc816020860160208601614ab8565b601f01601f19169290920160200192915050565b602081526000611d3b6020830184614ae4565b60008060008060008060008060e0898b031215614b3f57600080fd5b8835614b4a8161476f565b9750614b5860208a016145f7565b9650604089013595506060890135945060808901356001600160401b0380821115614b8257600080fd5b614b8e8c838d0161460e565b9096509450849150614ba260a08c01614656565b935060c08b0135915080821115614bb857600080fd5b50614bc58b828c01614a2d565b9150509295985092959890939650565b600060208284031215614be757600080fd5b8135611d3b8161476f565b60008060408385031215614c0557600080fd5b614c0e836145f7565b9150614c1c602084016145f7565b90509250929050565b600080600080600080600080600060e08a8c031215614c4357600080fd5b614c4c8a6145f7565b985060208a0135975060408a0135965060608a01356001600160401b0380821115614c7657600080fd5b614c828d838e0161460e565b9098509650869150614c9660808d01614656565b955060a08c01359150614ca8826147c2565b90935060c08b01359080821115614cbe57600080fd5b50614ccb8c828d0161460e565b915080935050809150509295985092959850929598565b600080600080600060808688031215614cfa57600080fd5b614d03866145f7565b9450614d11602087016145f7565b93506040860135925060608601356001600160401b03811115614d3357600080fd5b614d3f8882890161460e565b969995985093965092949392505050565b600080600060608486031215614d6557600080fd5b6147a4846145f7565b6000806000806000806000806000806101008b8d031215614d8e57600080fd5b614d978b6145f7565b995060208b01356001600160401b0380821115614db357600080fd5b614dbf8e838f0161460e565b909b509950899150614dd360408e01614656565b985060608d0135975060808d01359150614dec8261476f565b90955060a08c0135945060c08c01359080821115614e0957600080fd5b50614e168d828e0161460e565b9150809450508092505060e08b013590509295989b9194979a5092959850565b60008060008060808587031215614e4c57600080fd5b614e55856145f7565b9350614e63602086016145f7565b92506040850135614e738161476f565b9396929550929360600135925050565b600181811c90821680614e9757607f821691505b602082108103614a3f57634e487b7160e01b600052602260045260246000fd5b8183823760009101908152919050565b60208082526026908201527f4c7a4170703a20696e76616c696420736f757263652073656e64696e6720636f6040820152651b9d1c9858dd60d21b606082015260800190565b600060208284031215614f1f57600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b600082821015614f4e57614f4e614f26565b500390565b60008219821115614f6657614f66614f26565b500190565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff84168152604060208201526000612443604083018486614f6b565b6000808335601e19843603018112614fc957600080fd5b8301803591506001600160401b03821115614fe357600080fd5b60200191503681900382131561464f57600080fd5b6000825161500a818460208701614ab8565b9190910192915050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b600061ffff8088168352808716602084015250846040830152608060608301526140c5608083018486614f6b565b61ffff8916815260c06020820152600061508660c08301898b614f6b565b6001600160401b038816604084015286606084015285608084015282810360a08401526150b4818587614f6b565b9b9a5050505050505050505050565b6000602082840312156150d557600080fd5b81516001600160401b038111156150eb57600080fd5b8201601f810184136150fc57600080fd5b805161510a6149a482614925565b81815285602083850101111561511f57600080fd5b612efa826020830160208601614ab8565b61ffff8516815260806020820152600061514d6080830186614ae4565b6001600160401b038516604084015282810360608401526140c58185614ae4565b61ffff861681526001600160a01b038516602082015260a06040820181905260009061519c90830186614ae4565b841515606084015282810360808401526151b68185614ae4565b98975050505050505050565b600080604083850312156151d557600080fd5b505080516020909101519092909150565b61ffff86168152608060208201526000615204608083018688614f6b565b6001600160401b0394909416604083015250606001529392505050565b61ffff8616815260a06020820152600061523e60a0830187614ae4565b6001600160401b0386166040840152828103606084015261525f8186614ae4565b905082810360808401526151b68185614ae4565b634e487b7160e01b600052601260045260246000fd5b60008261529857615298615273565b500490565b6000602082840312156152af57600080fd5b8151611d3b816147c2565b600061010061ffff8b1683528060208401526152d88184018b614ae4565b6001600160401b038a166040850152606084018990526001600160a01b038816608085015260a0840187905283810360c085015290506153188186614ae4565b9150508260e08301529998505050505050505050565b6060815260006153416060830186614ae4565b6001600160401b039490941660208301525060400152919050565b60008261536b5761536b615273565b500690565b61ffff8716815260c06020820152600061538d60c0830188614ae4565b828103604084015261539f8188614ae4565b6001600160a01b0387811660608601528616608085015283810360a085015290506153ca8185614ae4565b9998505050505050505050565b60ff60f81b8760f81b16815285600182015260006001600160401b0360c01b808760c01b166021840152856029840152808560c01b166049840152508251615426816051850160208701614ab8565b91909101605101979650505050505050565b600081600019048311821515161561545257615452614f26565b50029056fea264697066735822122002e85e39cd4c45156c727cd464d515ec143b5814676650286110a986cc477f2264736f6c634300080d0033", - "deployedBytecode": "0x6080604052600436106103b75760003560e01c80637dc0d1d0116101f2578063baf3292d1161010d578063df2a5b3b116100a0578063f2fde38b1161006f578063f2fde38b14610c52578063f5ecbdbc14610c72578063fc0c546a14610c92578063fdff235b14610cc557600080fd5b8063df2a5b3b14610bdd578063e6a20ae614610bfd578063eaffd49a14610c12578063eb8d72b714610c3257600080fd5b8063cc01e9b6116100dc578063cc01e9b614610b50578063cc7015ae14610b70578063d1deba1f14610b9d578063d708a46814610bb057600080fd5b8063baf3292d14610ae0578063c1e9132e14610b00578063c446183414610b1a578063cbed8b9c14610b3057600080fd5b806393a61d6c116101855780639f38369a116101545780639f38369a14610a4c578063a4c51df514610a6c578063a6c3d16514610a8c578063b353aaa714610aac57600080fd5b806393a61d6c1461097d578063950c8a74146109aa5780639b19251a146109ca5780639bdb9812146109fa57600080fd5b80638cfd8f5c116101c15780638cfd8f5c146108e05780638da5cb5b14610918578063904365671461093b5780639358928b1461096857600080fd5b80637dc0d1d01461083a5780638456cb591461087757806384e69c691461088c578063857749b0146108ac57600080fd5b80634c42899a116102e257806364aff9ec11610275578063715018a611610244578063715018a6146107ce5780637533d788146107da57806376203b48146108075780637adbf9731461081a57600080fd5b806364aff9ec1461075b57806366ad5c8a1461077b578063695ef6bf1461079b57806369c1e7b8146107ae57600080fd5b806353489d6c116102b157806353489d6c146106b457806353d6fd59146106d45780635b8c41e6146106f45780635c975abb1461074357600080fd5b80634c42899a146106135780634cec62561461063a5780634ed2c662146106675780634f4ba0f41461068757600080fd5b80632dbbec081161035a5780633f1f4fa4116103295780633f1f4fa41461059c5780633f4ba83a146105c957806342d65a8d146105de57806344770515146105fe57600080fd5b80632dbbec08146104ec578063365260b41461050c5780633c4ec39b146105415780633d8b38f61461057c57600080fd5b80630df37483116103965780630df374831461043357806310ddb13714610453578063182b4b89146104735780632488eec8146104cc57600080fd5b80621d3567146103bc57806301ffc9a7146103de57806307e0db1714610413575b600080fd5b3480156103c857600080fd5b506103dc6103d736600461466d565b610cf2565b005b3480156103ea57600080fd5b506103fe6103f9366004614700565b610ee4565b60405190151581526020015b60405180910390f35b34801561041f57600080fd5b506103dc61042e36600461472a565b610f1b565b34801561043f57600080fd5b506103dc61044e366004614745565b610fa4565b34801561045f57600080fd5b506103dc61046e36600461472a565b610fc3565b34801561047f57600080fd5b5061049361048e366004614784565b61101b565b6040805197151588526020880196909652948601939093526060850191909152608084015260a0830152151560c082015260e00161040a565b3480156104d857600080fd5b506103dc6104e7366004614745565b611191565b3480156104f857600080fd5b506103dc61050736600461472a565b611275565b34801561051857600080fd5b5061052c6105273660046147d0565b6112d4565b6040805192835260208301919091520161040a565b34801561054d57600080fd5b5061056e61055c36600461472a565b600d6020526000908152604090205481565b60405190815260200161040a565b34801561058857600080fd5b506103fe610597366004614837565b611329565b3480156105a857600080fd5b5061056e6105b736600461472a565b60036020526000908152604090205481565b3480156105d557600080fd5b506103dc6113f5565b3480156105ea57600080fd5b506103dc6105f9366004614837565b611407565b34801561060a57600080fd5b5061056e600081565b34801561061f57600080fd5b50610628600081565b60405160ff909116815260200161040a565b34801561064657600080fd5b5061056e61065536600461472a565b600a6020526000908152604090205481565b34801561067357600080fd5b506103dc610682366004614889565b61148d565b34801561069357600080fd5b5061056e6106a236600461472a565b60096020526000908152604090205481565b3480156106c057600080fd5b506103dc6106cf366004614745565b6114d2565b3480156106e057600080fd5b506103dc6106ef3660046148a6565b6115b6565b34801561070057600080fd5b5061056e61070f36600461494c565b6005602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205481565b34801561074f57600080fd5b5060005460ff166103fe565b34801561076757600080fd5b506103dc6107763660046149ec565b61162e565b34801561078757600080fd5b506103dc61079636600461466d565b611735565b6103dc6107a9366004614a45565b611811565b3480156107ba57600080fd5b506103dc6107c9366004614745565b61187c565b3480156103dc57600080fd5b3480156107e657600080fd5b506107fa6107f536600461472a565b611968565b60405161040a9190614b10565b6103dc610815366004614b23565b611a02565b34801561082657600080fd5b506103dc610835366004614bd5565b611a6e565b34801561084657600080fd5b5060075461085f9061010090046001600160a01b031681565b6040516001600160a01b03909116815260200161040a565b34801561088357600080fd5b506103dc611ae6565b34801561089857600080fd5b506103dc6108a736600461494c565b611af6565b3480156108b857600080fd5b506106287f000000000000000000000000000000000000000000000000000000000000000081565b3480156108ec57600080fd5b5061056e6108fb366004614bf2565b600260209081526000928352604080842090915290825290205481565b34801561092457600080fd5b5060005461010090046001600160a01b031661085f565b34801561094757600080fd5b5061056e61095636600461472a565b600c6020526000908152604090205481565b34801561097457600080fd5b5061056e611ba3565b34801561098957600080fd5b5061056e61099836600461472a565b600b6020526000908152604090205481565b3480156109b657600080fd5b5060045461085f906001600160a01b031681565b3480156109d657600080fd5b506103fe6109e5366004614bd5565b60106020526000908152604090205460ff1681565b348015610a0657600080fd5b506103fe610a1536600461494c565b6006602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205460ff1681565b348015610a5857600080fd5b506107fa610a6736600461472a565b611c2c565b348015610a7857600080fd5b5061052c610a87366004614c25565b611d42565b348015610a9857600080fd5b506103dc610aa7366004614837565b611dd1565b348015610ab857600080fd5b5061085f7f000000000000000000000000000000000000000000000000000000000000000081565b348015610aec57600080fd5b506103dc610afb366004614bd5565b611e64565b348015610b0c57600080fd5b506007546103fe9060ff1681565b348015610b2657600080fd5b5061056e61271081565b348015610b3c57600080fd5b506103dc610b4b366004614ce2565b611eba565b348015610b5c57600080fd5b506103dc610b6b366004614745565b611f4f565b348015610b7c57600080fd5b5061056e610b8b36600461472a565b60086020526000908152604090205481565b6103dc610bab36600461466d565b61203b565b348015610bbc57600080fd5b5061056e610bcb36600461472a565b600e6020526000908152604090205481565b348015610be957600080fd5b506103dc610bf8366004614d50565b61213f565b348015610c0957600080fd5b50610628600181565b348015610c1e57600080fd5b506103dc610c2d366004614d6e565b6121a9565b348015610c3e57600080fd5b506103dc610c4d366004614837565b6122c8565b348015610c5e57600080fd5b506103dc610c6d366004614bd5565b612322565b348015610c7e57600080fd5b506107fa610c8d366004614e36565b61239b565b348015610c9e57600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061085f565b348015610cd157600080fd5b5061056e610ce036600461472a565b600f6020526000908152604090205481565b337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031614610d6f5760405162461bcd60e51b815260206004820152601e60248201527f4c7a4170703a20696e76616c696420656e64706f696e742063616c6c6572000060448201526064015b60405180910390fd5b61ffff861660009081526001602052604081208054610d8d90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054610db990614e83565b8015610e065780601f10610ddb57610100808354040283529160200191610e06565b820191906000526020600020905b815481529060010190602001808311610de957829003601f168201915b50505050509050805186869050148015610e21575060008151115b8015610e49575080516020820120604051610e3f9088908890614eb7565b6040518091039020145b610e655760405162461bcd60e51b8152600401610d6690614ec7565b610edb8787878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8a018190048102820181019092528881528a93509150889088908190840183828082843760009201919091525061244e92505050565b50505050505050565b60006001600160e01b03198216631f7ecdf760e01b1480610f1557506301ffc9a760e01b6001600160e01b03198316145b92915050565b610f236124c7565b6040516307e0db1760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906307e0db17906024015b600060405180830381600087803b158015610f8957600080fd5b505af1158015610f9d573d6000803e3d6000fd5b5050505050565b610fac6124c7565b61ffff909116600090815260036020526040902055565b610fcb6124c7565b6040516310ddb13760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906310ddb13790602401610f6f565b6001600160a01b03838116600090815260106020908152604080832054815192830190915260075492938493849384938493849360ff909216928492909182916101009004166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156110cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110ef9190614f0d565b905290506110fd818a612527565b61ffff8b166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054919a509098509196509094509250426201518061114b8583614f3c565b111561115c57859450809350611169565b6111668686614f53565b94505b828061118057508786111580156111805750868511155b985050509397509397509397909450565b6111996124c7565b61ffff821660009081526008602052604090205481101561120b5760405162461bcd60e51b815260206004820152602660248201527f4461696c79206c696d6974203c2073696e676c65207472616e73616374696f6e604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600960209081526040918290205482519384529083015281018290527f4dd31065e259d5284e44d1f9265710da72eafcf78dc925e3881189fc3b71f6939060600160405180910390a161ffff909116600090815260096020526040902055565b61127d6124c7565b61ffff81166000908152600160205260408120611299916144b0565b60405161ffff821681527f6d5075c81d4d9e75bec6052f4e44f58f8a8cf1327544addbbf015fb06f83bd37906020015b60405180910390a150565b60008061131a8888888888888080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061253f92505050565b91509150965096945050505050565b61ffff83166000908152600160205260408120805482919061134a90614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461137690614e83565b80156113c35780601f10611398576101008083540402835291602001916113c3565b820191906000526020600020905b8154815290600101906020018083116113a657829003601f168201915b5050505050905083836040516113da929190614eb7565b60405180910390208180519060200120149150509392505050565b6113fd6124c7565b611405612633565b565b61140f6124c7565b6040516342d65a8d60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906342d65a8d9061145f90869086908690600401614f94565b600060405180830381600087803b15801561147957600080fd5b505af1158015610edb573d6000803e3d6000fd5b6114956124c7565b6007805460ff19168215159081179091556040517fe628f01c6f4e6340598d3a2913390db68e8859379eebff349e170f2b16baed0090600090a250565b6114da6124c7565b61ffff821660009081526009602052604090205481111561154c5760405162461bcd60e51b815260206004820152602660248201527f53696e676c65207472616e73616374696f6e206c696d6974203e204461696c79604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600860209081526040918290205482519384529083015281018290527f7babeac42ccbb33537ee421fedc4db7b5f251b5d2a3fa5c0ff4b35b2d783be879060600160405180910390a161ffff909116600090815260086020526040902055565b6115be6124c7565b816001600160a01b03167ff6019ec0a78d156d249a1ec7579e2321f6ac7521d6e1d2eacf90ba4a184dcceb826040516115fb911515815260200190565b60405180910390a26001600160a01b03919091166000908152601060205260409020805460ff1916911515919091179055565b6116366124c7565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a0823190602401602060405180830381865afa15801561167d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a19190614f0d565b9050808211156116ce5760405163cf47918160e01b81526004810183905260248101829052604401610d66565b826001600160a01b0316846001600160a01b03167f6d25be279134f4ecaa4770aff0c3d916d9e7c5ef37b65ed95dbdba411f5d54d58460405161171391815260200190565b60405180910390a361172f6001600160a01b0385168484612685565b50505050565b3330146117935760405162461bcd60e51b815260206004820152602660248201527f4e6f6e626c6f636b696e674c7a4170703a2063616c6c6572206d7573742062656044820152650204c7a4170760d41b6064820152608401610d66565b6118098686868080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8901819004810282018101909252878152899350915087908790819084018382808284376000920191909152506126ed92505050565b505050505050565b611809858585856118256020870187614bd5565b6118356040880160208901614bd5565b6118426040890189614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061277492505050565b6118846124c7565b61ffff82166000908152600c60205260409020548110156118fe5760405162461bcd60e51b815260206004820152602e60248201527f4461696c79206c696d6974203c2073696e676c6520726563656976652074726160448201526d1b9cd858dd1a5bdb881b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600d60209081526040918290205482519384529083015281018290527f95dc51094cd27cf4ee3fd0dbb50cf96f8df1629c822f5434c4a34d7eb03c97249060600160405180910390a161ffff9091166000908152600d6020526040902055565b6001602052600090815260409020805461198190614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90614e83565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b505050505081565b60075460ff16611a545760405162461bcd60e51b815260206004820152601760248201527f73656e64416e6443616c6c2069732064697361626c65640000000000000000006044820152606401610d66565b611a64888888888888888861285c565b5050505050505050565b611a766124c7565b611a7f81612900565b6007546040516001600160a01b0380841692610100900416907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd90600090a3600780546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b611aee6124c7565b611405612927565b611afe6124c7565b61ffff83166000908152600560205260408082209051611b1f908590614ff8565b9081526040805191829003602090810183206001600160401b038616600090815291522091909155611b52908390614ff8565b6040805191829003822061ffff861683526001600160401b0384166020840152917f48a980eea4ea1c540209e2f9f32a4c2edf51fab37b1d21f453868301ecb6e2ee910160405180910390a2505050565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c03573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c279190614f0d565b905090565b61ffff8116600090815260016020526040812080546060929190611c4f90614e83565b80601f0160208091040260200160405190810160405280929190818152602001828054611c7b90614e83565b8015611cc85780601f10611c9d57610100808354040283529160200191611cc8565b820191906000526020600020905b815481529060010190602001808311611cab57829003601f168201915b505050505090508051600003611d205760405162461bcd60e51b815260206004820152601d60248201527f4c7a4170703a206e6f20747275737465642070617468207265636f72640000006044820152606401610d66565b611d3b600060148351611d339190614f3c565b839190612964565b9392505050565b600080611dbf8b8b8b8b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b81528e93508d9250908c908c9081908401838280828437600092019190915250612a7192505050565b91509150995099975050505050505050565b611dd96124c7565b818130604051602001611dee93929190615014565b60408051601f1981840301815291815261ffff85166000908152600160209081529190208251611e23939192909101906144ea565b507f8c0400cfe2d1199b1a725c78960bcc2a344d869b80590d0f2bd005db15a572ce838383604051611e5793929190614f94565b60405180910390a1505050565b611e6c6124c7565b600480546001600160a01b0319166001600160a01b0383169081179091556040519081527f5db758e995a17ec1ad84bdef7e8c3293a0bd6179bcce400dff5d4c3d87db726b906020016112c9565b611ec26124c7565b6040516332fb62e760e21b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cbed8b9c90611f16908890889088908890889060040161503a565b600060405180830381600087803b158015611f3057600080fd5b505af1158015611f44573d6000803e3d6000fd5b505050505050505050565b611f576124c7565b61ffff82166000908152600d6020526040902054811115611fd15760405162461bcd60e51b815260206004820152602e60248201527f73696e676c652072656365697665207472616e73616374696f6e206c696d697460448201526d080f8811185a5b1e481b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600c60209081526040918290205482519384529083015281018290527f2c42997a938a029910a78e7c28d762b349c28e70f3a89c1fbccbb1a46020b1599060600160405180910390a161ffff9091166000908152600c6020526040902055565b61ffff86166000908152600160205260408120805461205990614e83565b80601f016020809104026020016040519081016040528092919081815260200182805461208590614e83565b80156120d25780601f106120a7576101008083540402835291602001916120d2565b820191906000526020600020905b8154815290600101906020018083116120b557829003601f168201915b505050505090508051868690501480156120ed575060008151115b801561211557508051602082012060405161210b9088908890614eb7565b6040518091039020145b6121315760405162461bcd60e51b8152600401610d6690614ec7565b610edb878787878787612b33565b6121476124c7565b61ffff83811660008181526002602090815260408083209487168084529482529182902085905581519283528201929092529081018290527f9d5c7c0b934da8fefa9c7760c98383778a12dfbfc0c3b3106518f43fb9508ac090606001611e57565b3330146121f85760405162461bcd60e51b815260206004820152601f60248201527f4f4654436f72653a2063616c6c6572206d757374206265204f4654436f7265006044820152606401610d66565b612203308686612d49565b9350846001600160a01b03168a61ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8660405161224591815260200190565b60405180910390a3604051633fe79aed60e11b81526001600160a01b03861690637fcf35da908390612289908e908e908e908e908e908d908d908d90600401615068565b600060405180830381600088803b1580156122a357600080fd5b5087f11580156122b7573d6000803e3d6000fd5b505050505050505050505050505050565b6122d06124c7565b61ffff831660009081526001602052604090206122ee90838361456e565b507ffa41487ad5d6728f0b19276fa1eddc16558578f5109fc39d2dc33c3230470dab838383604051611e5793929190614f94565b61232a6124c7565b6001600160a01b03811661238f5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d66565b61239881612f03565b50565b604051633d7b2f6f60e21b815261ffff808616600483015284166024820152306044820152606481018290526060907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03169063f5ecbdbc90608401600060405180830381865afa15801561241b573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261244391908101906150c3565b90505b949350505050565b6000806124b15a60966366ad5c8a60e01b898989896040516024016124769493929190615130565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915230929190612f5c565b9150915081611809576118098686868685612fe6565b6000546001600160a01b036101009091041633146114055760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d66565b6000806125348484613083565b9050612446816130b4565b600080600061258d87612551886130cc565b6040805160006020820152602181019390935260c09190911b6001600160c01b0319166041830152805160298184030181526049909201905290565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb10906125e4908b90309086908b908b9060040161516e565b6040805180830381865afa158015612600573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061262491906151c2565b92509250509550959350505050565b61263b613152565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6040516001600160a01b0383166024820152604481018290526126e890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261319b565b505050565b60006126f98282613270565b905060ff81166127145761270f858585856132cc565b610f9d565b60001960ff82160161272c5761270f8585858561335c565b60405162461bcd60e51b815260206004820152601c60248201527f4f4654436f72653a20756e6b6e6f776e207061636b65742074797065000000006044820152606401610d66565b60006127828782848161356a565b61278b8561363f565b50905061279a8888888461367f565b9050600081116127e85760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006127f787612551846130cc565b9050612807888287878734613782565b86896001600160a01b03168961ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a8560405161284891815260200190565b60405180910390a450979650505050505050565b611f448888888888888080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a92506128a99150506020890189614bd5565b6128b960408a0160208b01614bd5565b6128c660408b018b614fb2565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061392792505050565b6001600160a01b038116612398576040516342bcdf7f60e11b815260040160405180910390fd5b61292f613a1c565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586126683390565b60608161297281601f614f53565b10156129b15760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b6044820152606401610d66565b6129bb8284614f53565b845110156129ff5760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b6044820152606401610d66565b606082158015612a1e5760405191506000825260208201604052612a68565b6040519150601f8416801560200281840101858101878315602002848b0101015b81831015612a57578051835260209283019201612a3f565b5050858452601f01601f1916604052505b50949350505050565b6000806000612a8b338a612a848b6130cc565b8a8a613a62565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb1090612ae2908d90309086908b908b9060040161516e565b6040805180830381865afa158015612afe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b2291906151c2565b925092505097509795505050505050565b61ffff86166000908152600560205260408082209051612b569088908890614eb7565b90815260408051602092819003830190206001600160401b03871660009081529252902054905080612bd65760405162461bcd60e51b815260206004820152602360248201527f4e6f6e626c6f636b696e674c7a4170703a206e6f2073746f726564206d65737360448201526261676560e81b6064820152608401610d66565b808383604051612be7929190614eb7565b604051809103902014612c465760405162461bcd60e51b815260206004820152602160248201527f4e6f6e626c6f636b696e674c7a4170703a20696e76616c6964207061796c6f616044820152601960fa1b6064820152608401610d66565b61ffff87166000908152600560205260408082209051612c699089908990614eb7565b90815260408051602092819003830181206001600160401b038916600090815290845282902093909355601f88018290048202830182019052868252612d01918991899089908190840183828082843760009201919091525050604080516020601f8a018190048102820181019092528881528a9350915088908890819084018382808284376000920191909152506126ed92505050565b7fc264d91f3adc5588250e1551f547752ca0cfa8f6b530d243b9f9f4cab10ea8e58787878785604051612d389594939291906151e6565b60405180910390a150505050505050565b6000612d53613a1c565b6040516370a0823160e01b81526001600160a01b0384811660048301526000917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612dbe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612de29190614f0d565b9050306001600160a01b03861603612e2d57612e286001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168585612685565b612e62565b612e626001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016868686613aa3565b6040516370a0823160e01b81526001600160a01b03858116600483015282917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612ecc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612ef09190614f0d565b612efa9190614f3c565b95945050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6000606060008060008661ffff166001600160401b03811115612f8157612f816148df565b6040519080825280601f01601f191660200182016040528015612fab576020820181803683370190505b50905060008087516020890160008d8df191503d925086831115612fcd578692505b828152826000602083013e909890975095505050505050565b8180519060200120600560008761ffff1661ffff168152602001908152602001600020856040516130179190614ff8565b9081526040805191829003602090810183206001600160401b0388166000908152915220919091557fe183f33de2837795525b4792ca4cd60535bd77c53b7e7030060bfcf5734d6b0c906130749087908790879087908790615221565b60405180910390a15050505050565b60408051602081019091526000815260405180602001604052806130ab856000015185613adb565b90529392505050565b8051600090610f1590670de0b6b3a764000090615289565b6000806130f97f000000000000000000000000000000000000000000000000000000000000000084615289565b90506001600160401b03811115610f155760405162461bcd60e51b815260206004820152601a60248201527f4f4654436f72653a20616d6f756e745344206f766572666c6f770000000000006044820152606401610d66565b60005460ff166114055760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610d66565b60006131f0826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316613ae79092919063ffffffff16565b9050805160001480613211575080806020019051810190613211919061529d565b6126e85760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610d66565b600061327d826001614f53565b835110156132c35760405162461bcd60e51b8152602060048201526013602482015272746f55696e74385f6f75744f66426f756e647360681b6044820152606401610d66565b50016001015190565b6000806132d883613af6565b90925090506001600160a01b0382166132f15761dead91505b60006132fc82613b7b565b9050613309878483613bb0565b9050826001600160a01b03168761ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8360405161334b91815260200190565b60405180910390a350505050505050565b600080600080600061336d86613c4f565b945094509450945094506000600660008b61ffff1661ffff168152602001908152602001600020896040516133a29190614ff8565b90815260408051602092819003830190206001600160401b038b166000908152925281205460ff1691506133d585613b7b565b905081613443576133e78b3083613bb0565b61ffff8c1660009081526006602052604090819020905191925060019161340f908d90614ff8565b90815260408051602092819003830190206001600160401b038d16600090815292529020805460ff19169115159190911790555b6001600160a01b0386163b61349a576040516001600160a01b03871681527f9aedf5fdba8716db3b6705ca00150643309995d4f818a249ed6dde6677e7792d9060200160405180910390a15050505050505061172f565b8a8a8a8a8a8a868a60008a6134b8578b6001600160401b03166134ba565b5a5b90506000806134ec5a609663eaffd49a60e01b8e8e8e8d8d8d8d8d6040516024016124769897969594939291906152ba565b915091508115613545578751602089012060405161ffff8d16907fb8890edbfc1c74692f527444645f95489c3703cc2df42e4a366f5d06fa6cd88490613537908e908e90869061532e565b60405180910390a250613552565b6135528b8b8b8b85612fe6565b50505050505050505050505050505050505050505050565b600061357583613d06565b61ffff808716600090815260026020908152604080832093891683529290522054909150806135e65760405162461bcd60e51b815260206004820152601a60248201527f4c7a4170703a206d696e4761734c696d6974206e6f74207365740000000000006044820152606401610d66565b6135f08382614f53565b8210156118095760405162461bcd60e51b815260206004820152601b60248201527f4c7a4170703a20676173206c696d697420697320746f6f206c6f7700000000006044820152606401610d66565b60008061366c7f00000000000000000000000000000000000000000000000000000000000000008461535c565b90506136788184614f3c565b9150915091565b6000613689613a1c565b6001600160a01b03851633146136ec5760405162461bcd60e51b815260206004820152602260248201527f50726f78794f46543a206f776e6572206973206e6f742073656e642063616c6c60448201526132b960f11b6064820152608401610d66565b6136f7858584613d62565b604051632770a7eb60e21b81526001600160a01b038681166004830152602482018490527f00000000000000000000000000000000000000000000000000000000000000001690639dc29fac90604401600060405180830381600087803b15801561376157600080fd5b505af1158015613775573d6000803e3d6000fd5b5093979650505050505050565b61ffff8616600090815260016020526040812080546137a090614e83565b80601f01602080910402602001604051908101604052809291908181526020018280546137cc90614e83565b80156138195780601f106137ee57610100808354040283529160200191613819565b820191906000526020600020905b8154815290600101906020018083116137fc57829003601f168201915b50505050509050805160000361388a5760405162461bcd60e51b815260206004820152603060248201527f4c7a4170703a2064657374696e6174696f6e20636861696e206973206e6f742060448201526f61207472757374656420736f7572636560801b6064820152608401610d66565b613895878751613f84565b60405162c5803160e81b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063c58031009084906138ec908b9086908c908c908c908c90600401615370565b6000604051808303818588803b15801561390557600080fd5b505af1158015613919573d6000803e3d6000fd5b505050505050505050505050565b600061393f896001846001600160401b03891661356a565b6139488761363f565b5090506139578a8a8a8461367f565b9050600081116139a55760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006139b5338a612a84856130cc565b90506139c58a8287878734613782565b888b6001600160a01b03168b61ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a85604051613a0691815260200190565b60405180910390a4509998505050505050505050565b60005460ff16156114055760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610d66565b6060600185856001600160a01b0389168587604051602001613a89969594939291906153d7565b604051602081830303815290604052905095945050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261172f9085906323b872dd60e01b906084016126b1565b6000611d3b8284615438565b60606124468484600085613ff5565b60008080613b048482613270565b60ff16148015613b15575082516029145b613b5c5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613b6783600d6140d0565b9150613b74836021614135565b9050915091565b6000610f157f00000000000000000000000000000000000000000000000000000000000000006001600160401b038416615438565b6000613bba613a1c565b613bc5838584614192565b6040516340c10f1960e01b81526001600160a01b038481166004830152602482018490527f000000000000000000000000000000000000000000000000000000000000000016906340c10f1990604401600060405180830381600087803b158015613c2f57600080fd5b505af1158015613c43573d6000803e3d6000fd5b50939695505050505050565b600080806060816001613c628783613270565b60ff1614613cad5760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613cb886600d6140d0565b9350613cc5866021614135565b9250613cd28660296143b4565b9450613cdf866049614135565b9050613cfb6051808851613cf39190614f3c565b889190612964565b915091939590929450565b6000602282511015613d5a5760405162461bcd60e51b815260206004820152601c60248201527f4c7a4170703a20696e76616c69642061646170746572506172616d73000000006044820152606401610d66565b506022015190565b6001600160a01b03831660009081526010602052604090205460ff168015613d8a5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015613e17573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e3b9190614f0d565b90529050613e498185612527565b61ffff86166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054939550429390919081871115613ed25760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b62015180613ee08587614f3c565b1115613f045761ffff8a166000908152600b60205260409020859055869250613f11565b613f0e8784614f53565b92505b80831115613f615760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600a602052604090209690965550505050505050565b61ffff821660009081526003602052604081205490819003613fa557506127105b808211156126e85760405162461bcd60e51b815260206004820181905260248201527f4c7a4170703a207061796c6f61642073697a6520697320746f6f206c617267656044820152606401610d66565b6060824710156140565760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610d66565b600080866001600160a01b031685876040516140729190614ff8565b60006040518083038185875af1925050503d80600081146140af576040519150601f19603f3d011682016040523d82523d6000602084013e6140b4565b606091505b50915091506140c587838387614412565b979650505050505050565b60006140dd826014614f53565b835110156141255760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b6044820152606401610d66565b500160200151600160601b900490565b6000614142826008614f53565b835110156141895760405162461bcd60e51b8152602060048201526014602482015273746f55696e7436345f6f75744f66426f756e647360601b6044820152606401610d66565b50016008015190565b6001600160a01b03831660009081526010602052604090205460ff1680156141ba5750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015614247573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061426b9190614f0d565b905290506142798185612527565b61ffff86166000908152600f6020908152604080832054600e835281842054600c845282852054600d90945291909320549395504293909190818711156143025760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b620151806143108587614f3c565b11156143345761ffff8a166000908152600f60205260409020859055869250614341565b61433e8784614f53565b92505b808311156143915760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600e602052604090209690965550505050505050565b60006143c1826020614f53565b835110156144095760405162461bcd60e51b8152602060048201526015602482015274746f427974657333325f6f75744f66426f756e647360581b6044820152606401610d66565b50016020015190565b6060831561448157825160000361447a576001600160a01b0385163b61447a5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610d66565b5081612446565b61244683838151156144965781518083602001fd5b8060405162461bcd60e51b8152600401610d669190614b10565b5080546144bc90614e83565b6000825580601f106144cc575050565b601f01602090049060005260206000209081019061239891906145e2565b8280546144f690614e83565b90600052602060002090601f016020900481019282614518576000855561455e565b82601f1061453157805160ff191683800117855561455e565b8280016001018555821561455e579182015b8281111561455e578251825591602001919060010190614543565b5061456a9291506145e2565b5090565b82805461457a90614e83565b90600052602060002090601f01602090048101928261459c576000855561455e565b82601f106145b55782800160ff1982351617855561455e565b8280016001018555821561455e579182015b8281111561455e5782358255916020019190600101906145c7565b5b8082111561456a57600081556001016145e3565b803561ffff8116811461460957600080fd5b919050565b60008083601f84011261462057600080fd5b5081356001600160401b0381111561463757600080fd5b60208301915083602082850101111561464f57600080fd5b9250929050565b80356001600160401b038116811461460957600080fd5b6000806000806000806080878903121561468657600080fd5b61468f876145f7565b955060208701356001600160401b03808211156146ab57600080fd5b6146b78a838b0161460e565b90975095508591506146cb60408a01614656565b945060608901359150808211156146e157600080fd5b506146ee89828a0161460e565b979a9699509497509295939492505050565b60006020828403121561471257600080fd5b81356001600160e01b031981168114611d3b57600080fd5b60006020828403121561473c57600080fd5b611d3b826145f7565b6000806040838503121561475857600080fd5b614761836145f7565b946020939093013593505050565b6001600160a01b038116811461239857600080fd5b60008060006060848603121561479957600080fd5b83356147a48161476f565b92506147b2602085016145f7565b9150604084013590509250925092565b801515811461239857600080fd5b60008060008060008060a087890312156147e957600080fd5b6147f2876145f7565b955060208701359450604087013593506060870135614810816147c2565b925060808701356001600160401b0381111561482b57600080fd5b6146ee89828a0161460e565b60008060006040848603121561484c57600080fd5b614855846145f7565b925060208401356001600160401b0381111561487057600080fd5b61487c8682870161460e565b9497909650939450505050565b60006020828403121561489b57600080fd5b8135611d3b816147c2565b600080604083850312156148b957600080fd5b82356148c48161476f565b915060208301356148d4816147c2565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561491d5761491d6148df565b604052919050565b60006001600160401b0382111561493e5761493e6148df565b50601f01601f191660200190565b60008060006060848603121561496157600080fd5b61496a846145f7565b925060208401356001600160401b0381111561498557600080fd5b8401601f8101861361499657600080fd5b80356149a96149a482614925565b6148f5565b8181528760208385010111156149be57600080fd5b816020840160208301376000602083830101528094505050506149e360408501614656565b90509250925092565b600080600060608486031215614a0157600080fd5b8335614a0c8161476f565b92506020840135614a1c8161476f565b929592945050506040919091013590565b600060608284031215614a3f57600080fd5b50919050565b600080600080600060a08688031215614a5d57600080fd5b8535614a688161476f565b9450614a76602087016145f7565b9350604086013592506060860135915060808601356001600160401b03811115614a9f57600080fd5b614aab88828901614a2d565b9150509295509295909350565b60005b83811015614ad3578181015183820152602001614abb565b8381111561172f5750506000910152565b60008151808452614afc816020860160208601614ab8565b601f01601f19169290920160200192915050565b602081526000611d3b6020830184614ae4565b60008060008060008060008060e0898b031215614b3f57600080fd5b8835614b4a8161476f565b9750614b5860208a016145f7565b9650604089013595506060890135945060808901356001600160401b0380821115614b8257600080fd5b614b8e8c838d0161460e565b9096509450849150614ba260a08c01614656565b935060c08b0135915080821115614bb857600080fd5b50614bc58b828c01614a2d565b9150509295985092959890939650565b600060208284031215614be757600080fd5b8135611d3b8161476f565b60008060408385031215614c0557600080fd5b614c0e836145f7565b9150614c1c602084016145f7565b90509250929050565b600080600080600080600080600060e08a8c031215614c4357600080fd5b614c4c8a6145f7565b985060208a0135975060408a0135965060608a01356001600160401b0380821115614c7657600080fd5b614c828d838e0161460e565b9098509650869150614c9660808d01614656565b955060a08c01359150614ca8826147c2565b90935060c08b01359080821115614cbe57600080fd5b50614ccb8c828d0161460e565b915080935050809150509295985092959850929598565b600080600080600060808688031215614cfa57600080fd5b614d03866145f7565b9450614d11602087016145f7565b93506040860135925060608601356001600160401b03811115614d3357600080fd5b614d3f8882890161460e565b969995985093965092949392505050565b600080600060608486031215614d6557600080fd5b6147a4846145f7565b6000806000806000806000806000806101008b8d031215614d8e57600080fd5b614d978b6145f7565b995060208b01356001600160401b0380821115614db357600080fd5b614dbf8e838f0161460e565b909b509950899150614dd360408e01614656565b985060608d0135975060808d01359150614dec8261476f565b90955060a08c0135945060c08c01359080821115614e0957600080fd5b50614e168d828e0161460e565b9150809450508092505060e08b013590509295989b9194979a5092959850565b60008060008060808587031215614e4c57600080fd5b614e55856145f7565b9350614e63602086016145f7565b92506040850135614e738161476f565b9396929550929360600135925050565b600181811c90821680614e9757607f821691505b602082108103614a3f57634e487b7160e01b600052602260045260246000fd5b8183823760009101908152919050565b60208082526026908201527f4c7a4170703a20696e76616c696420736f757263652073656e64696e6720636f6040820152651b9d1c9858dd60d21b606082015260800190565b600060208284031215614f1f57600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b600082821015614f4e57614f4e614f26565b500390565b60008219821115614f6657614f66614f26565b500190565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff84168152604060208201526000612443604083018486614f6b565b6000808335601e19843603018112614fc957600080fd5b8301803591506001600160401b03821115614fe357600080fd5b60200191503681900382131561464f57600080fd5b6000825161500a818460208701614ab8565b9190910192915050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b600061ffff8088168352808716602084015250846040830152608060608301526140c5608083018486614f6b565b61ffff8916815260c06020820152600061508660c08301898b614f6b565b6001600160401b038816604084015286606084015285608084015282810360a08401526150b4818587614f6b565b9b9a5050505050505050505050565b6000602082840312156150d557600080fd5b81516001600160401b038111156150eb57600080fd5b8201601f810184136150fc57600080fd5b805161510a6149a482614925565b81815285602083850101111561511f57600080fd5b612efa826020830160208601614ab8565b61ffff8516815260806020820152600061514d6080830186614ae4565b6001600160401b038516604084015282810360608401526140c58185614ae4565b61ffff861681526001600160a01b038516602082015260a06040820181905260009061519c90830186614ae4565b841515606084015282810360808401526151b68185614ae4565b98975050505050505050565b600080604083850312156151d557600080fd5b505080516020909101519092909150565b61ffff86168152608060208201526000615204608083018688614f6b565b6001600160401b0394909416604083015250606001529392505050565b61ffff8616815260a06020820152600061523e60a0830187614ae4565b6001600160401b0386166040840152828103606084015261525f8186614ae4565b905082810360808401526151b68185614ae4565b634e487b7160e01b600052601260045260246000fd5b60008261529857615298615273565b500490565b6000602082840312156152af57600080fd5b8151611d3b816147c2565b600061010061ffff8b1683528060208401526152d88184018b614ae4565b6001600160401b038a166040850152606084018990526001600160a01b038816608085015260a0840187905283810360c085015290506153188186614ae4565b9150508260e08301529998505050505050505050565b6060815260006153416060830186614ae4565b6001600160401b039490941660208301525060400152919050565b60008261536b5761536b615273565b500690565b61ffff8716815260c06020820152600061538d60c0830188614ae4565b828103604084015261539f8188614ae4565b6001600160a01b0387811660608601528616608085015283810360a085015290506153ca8185614ae4565b9998505050505050505050565b60ff60f81b8760f81b16815285600182015260006001600160401b0360c01b808760c01b166021840152856029840152808560c01b166049840152508251615426816051850160208701614ab8565b91909101605101979650505050505050565b600081600019048311821515161561545257615452614f26565b50029056fea264697066735822122002e85e39cd4c45156c727cd464d515ec143b5814676650286110a986cc477f2264736f6c634300080d0033", + "solcInputHash": "15770bc3af16acbd95d8914f14cae6d7", + "metadata": "{\"compiler\":{\"version\":\"0.8.25+commit.b61c2a91\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress_\",\"type\":\"address\"},{\"internalType\":\"uint8\",\"name\":\"sharedDecimals_\",\"type\":\"uint8\"},{\"internalType\":\"address\",\"name\":\"lzEndpoint_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"oracle_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"sweepAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"name\":\"InsufficientBalance\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"_hash\",\"type\":\"bytes32\"}],\"name\":\"CallOFTReceivedSuccess\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"srcChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"bytes\",\"name\":\"srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"nonce\",\"type\":\"uint64\"}],\"name\":\"DropFailedMessage\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"innerToken\",\"type\":\"address\"}],\"name\":\"InnerTokenAdded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_reason\",\"type\":\"bytes\"}],\"name\":\"MessageFailed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"NonContractAddress\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"oldOracle\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOracle\",\"type\":\"address\"}],\"name\":\"OracleChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"ReceiveFromChain\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"_payloadHash\",\"type\":\"bytes32\"}],\"name\":\"RetryMessageSuccess\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"SendToChain\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxDailyLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxDailyReceiveLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxSingleReceiveTransactionLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxLimit\",\"type\":\"uint256\"}],\"name\":\"SetMaxSingleTransactionLimit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_type\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_minDstGas\",\"type\":\"uint256\"}],\"name\":\"SetMinDstGas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"precrime\",\"type\":\"address\"}],\"name\":\"SetPrecrime\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_path\",\"type\":\"bytes\"}],\"name\":\"SetTrustedRemote\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"_remoteAddress\",\"type\":\"bytes\"}],\"name\":\"SetTrustedRemoteAddress\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"addr\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isWhitelist\",\"type\":\"bool\"}],\"name\":\"SetWhitelist\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"sweepAmount\",\"type\":\"uint256\"}],\"name\":\"SweepToken\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"chainId\",\"type\":\"uint16\"}],\"name\":\"TrustedRemoteRemoved\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"UpdateSendAndCallEnabled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"DEFAULT_PAYLOAD_SIZE_LIMIT\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"NO_EXTRA_GAS\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"PT_SEND\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"PT_SEND_AND_CALL\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes32\",\"name\":\"_from\",\"type\":\"bytes32\"},{\"internalType\":\"address\",\"name\":\"_to\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"_gasForCall\",\"type\":\"uint256\"}],\"name\":\"callOnOFTReceived\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourReceiveWindowStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourReceived\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourTransferred\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToLast24HourWindowStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxDailyLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxDailyReceiveLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxSingleReceiveTransactionLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"chainIdToMaxSingleTransactionLimit\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"circulatingSupply\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"creditedPackets\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"srcChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"srcAddress_\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"nonce_\",\"type\":\"uint64\"}],\"name\":\"dropFailedMessage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_dstGasForCall\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"_useZro\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"_adapterParams\",\"type\":\"bytes\"}],\"name\":\"estimateSendAndCallFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"nativeFee\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"zroFee\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"_useZro\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"_adapterParams\",\"type\":\"bytes\"}],\"name\":\"estimateSendFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"nativeFee\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"zroFee\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"failedMessages\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"}],\"name\":\"forceResumeReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_chainId\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_configType\",\"type\":\"uint256\"}],\"name\":\"getConfig\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"}],\"name\":\"getTrustedRemoteAddress\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from_\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"dstChainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"isEligibleToSend\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"eligibleToSend\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"maxSingleTransactionLimit\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"maxDailyLimit\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"amountInUsd\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"transferredInWindow\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"last24HourWindowStart\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"isWhiteListedUser\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"}],\"name\":\"isTrustedRemote\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"lzEndpoint\",\"outputs\":[{\"internalType\":\"contract ILayerZeroEndpoint\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"lzReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"minDstGasLookup\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"nonblockingLzReceive\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"oracle\",\"outputs\":[{\"internalType\":\"contract ResilientOracleInterface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"payloadSizeLimitLookup\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"precrime\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"remoteChainId_\",\"type\":\"uint16\"}],\"name\":\"removeTrustedRemote\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_srcChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_srcAddress\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"_nonce\",\"type\":\"uint64\"},{\"internalType\":\"bytes\",\"name\":\"_payload\",\"type\":\"bytes\"}],\"name\":\"retryMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"from_\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"dstChainId_\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"toAddress_\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"payload_\",\"type\":\"bytes\"},{\"internalType\":\"uint64\",\"name\":\"dstGasForCall_\",\"type\":\"uint64\"},{\"components\":[{\"internalType\":\"address payable\",\"name\":\"refundAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"zroPaymentAddress\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"adapterParams\",\"type\":\"bytes\"}],\"internalType\":\"struct ICommonOFT.LzCallParams\",\"name\":\"callparams_\",\"type\":\"tuple\"}],\"name\":\"sendAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"sendAndCallEnabled\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_from\",\"type\":\"address\"},{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes32\",\"name\":\"_toAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"address payable\",\"name\":\"refundAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"zroPaymentAddress\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"adapterParams\",\"type\":\"bytes\"}],\"internalType\":\"struct ICommonOFT.LzCallParams\",\"name\":\"_callParams\",\"type\":\"tuple\"}],\"name\":\"sendFrom\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_chainId\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_configType\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"_config\",\"type\":\"bytes\"}],\"name\":\"setConfig\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxDailyLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxDailyReceiveLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxSingleReceiveTransactionLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"chainId_\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"limit_\",\"type\":\"uint256\"}],\"name\":\"setMaxSingleTransactionLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"_packetType\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_minGas\",\"type\":\"uint256\"}],\"name\":\"setMinDstGas\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"oracleAddress_\",\"type\":\"address\"}],\"name\":\"setOracle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_dstChainId\",\"type\":\"uint16\"},{\"internalType\":\"uint256\",\"name\":\"_size\",\"type\":\"uint256\"}],\"name\":\"setPayloadSizeLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_precrime\",\"type\":\"address\"}],\"name\":\"setPrecrime\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"}],\"name\":\"setReceiveVersion\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_version\",\"type\":\"uint16\"}],\"name\":\"setSendVersion\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_path\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemote\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"_remoteChainId\",\"type\":\"uint16\"},{\"internalType\":\"bytes\",\"name\":\"_remoteAddress\",\"type\":\"bytes\"}],\"name\":\"setTrustedRemoteAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"user_\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"val_\",\"type\":\"bool\"}],\"name\":\"setWhitelist\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"sharedDecimals\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes4\",\"name\":\"interfaceId\",\"type\":\"bytes4\"}],\"name\":\"supportsInterface\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"token_\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"to_\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount_\",\"type\":\"uint256\"}],\"name\":\"sweepToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"token\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint16\",\"name\":\"\",\"type\":\"uint16\"}],\"name\":\"trustedRemoteLookup\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"unpause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"enabled_\",\"type\":\"bool\"}],\"name\":\"updateSendAndCallEnabled\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"whitelist\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"events\":{\"Paused(address)\":{\"details\":\"Emitted when the pause is triggered by `account`.\"},\"ReceiveFromChain(uint16,address,uint256)\":{\"details\":\"Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain. `_nonce` is the inbound nonce.\"},\"SendToChain(uint16,address,bytes32,uint256)\":{\"details\":\"Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`) `_nonce` is the outbound nonce\"},\"Unpaused(address)\":{\"details\":\"Emitted when the pause is lifted by `account`.\"}},\"kind\":\"dev\",\"methods\":{\"circulatingSupply()\":{\"returns\":{\"_0\":\"total circulating supply of the token on the destination chain.\"}},\"dropFailedMessage(uint16,bytes,uint64)\":{\"custom:access\":\"Only owner\",\"custom:event\":\"Emits DropFailedMessage on clearance of failed message.\",\"params\":{\"nonce_\":\"Nonce_ of the transaction\",\"srcAddress_\":\"Address of source followed by current bridge address\",\"srcChainId_\":\"Chain id of source\"}},\"estimateSendFee(uint16,bytes32,uint256,bool,bytes)\":{\"details\":\"estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`) _dstChainId - L0 defined chain id to send tokens too _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain _amount - amount of the tokens to transfer _useZro - indicates to use zro to pay L0 fees _adapterParam - flexible bytes array to indicate messaging adapter services in L0\"},\"isEligibleToSend(address,uint16,uint256)\":{\"details\":\"This external view function assesses whether the specified sender is eligible to transfer the given amount to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\",\"params\":{\"amount_\":\"The quantity of tokens to be transferred.\",\"dstChainId_\":\"Indicates destination chain.\",\"from_\":\"The sender's address initiating the transfer.\"},\"returns\":{\"amountInUsd\":\"The equivalent amount in USD based on the oracle price.\",\"eligibleToSend\":\"A boolean indicating whether the sender is eligible to transfer the tokens.\",\"isWhiteListedUser\":\"A boolean indicating whether the sender is whitelisted.\",\"last24HourWindowStart\":\"The timestamp when the current 24-hour window started.\",\"maxDailyLimit\":\"The maximum daily limit for transactions.\",\"maxSingleTransactionLimit\":\"The maximum limit for a single transaction.\",\"transferredInWindow\":\"The total amount transferred in the current 24-hour window.\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pause()\":{\"custom:access\":\"Only owner.\"},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"removeTrustedRemote(uint16)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\",\"params\":{\"remoteChainId_\":\"The chain's id corresponds to setting the trusted remote to empty.\"}},\"sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))\":{\"details\":\"This internal override function enables the contract to send tokens and invoke calls on the specified destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\",\"params\":{\"amount_\":\"Amount of tokens that will be transferred.\",\"callparams_\":\"Additional parameters, including refund address, ZRO payment address, and adapter params.\",\"dstChainId_\":\"Destination chain id on which tokens will be send.\",\"dstGasForCall_\":\"The amount of gas allocated for the call on the destination chain.\",\"from_\":\"Address from which tokens will be debited.\",\"payload_\":\"Additional data payload for the call on the destination chain.\",\"toAddress_\":\"Address on which tokens will be credited on destination chain.\"}},\"sendFrom(address,uint16,bytes32,uint256,(address,address,bytes))\":{\"details\":\"send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from` `_from` the owner of token `_dstChainId` the destination chain identifier `_toAddress` can be any size depending on the `dstChainId`. `_amount` the quantity of tokens in wei `_refundAddress` the address LayerZero refunds if too much message fee is sent `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token) `_adapterParams` is a flexible bytes array to indicate messaging adapter services\"},\"setMaxDailyLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxDailyLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"Destination chain id.\",\"limit_\":\"Amount in USD(scaled with 18 decimals).\"}},\"setMaxDailyReceiveLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"The destination chain ID.\",\"limit_\":\"The new maximum daily limit in USD(scaled with 18 decimals).\"}},\"setMaxSingleReceiveTransactionLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"The destination chain ID.\",\"limit_\":\"The new maximum limit in USD(scaled with 18 decimals).\"}},\"setMaxSingleTransactionLimit(uint16,uint256)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\",\"params\":{\"chainId_\":\"Destination chain id.\",\"limit_\":\"Amount in USD(scaled with 18 decimals).\"}},\"setOracle(address)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits OracleChanged with old and new oracle address.\",\"details\":\"Reverts if the new address is zero.\",\"params\":{\"oracleAddress_\":\"The new address of the ResilientOracle contract.\"}},\"setWhitelist(address,bool)\":{\"custom:access\":\"Only owner.\",\"custom:event\":\"Emits setWhitelist.\",\"params\":{\"user_\":\"Address to be add in whitelist.\",\"val_\":\"Boolean to be set (true for user_ address is whitelisted).\"}},\"sweepToken(address,address,uint256)\":{\"custom:access\":\"Only Owner\",\"custom:error\":\"Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\",\"custom:event\":\"Emits SweepToken event\",\"params\":{\"amount_\":\"The amount of tokens needs to transfer\",\"to_\":\"The address of the recipient\",\"token_\":\"The address of the ERC-20 token to sweep\"}},\"token()\":{\"returns\":{\"_0\":\"Address of the inner token of this bridge.\"}},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"},\"unpause()\":{\"custom:access\":\"Only owner.\"},\"updateSendAndCallEnabled(bool)\":{\"params\":{\"enabled_\":\"Boolean indicating whether the sendAndCall function should be enabled or disabled.\"}}},\"title\":\"XVSProxyOFTDest\",\"version\":1},\"userdoc\":{\"errors\":{\"InsufficientBalance(uint256,uint256)\":[{\"notice\":\"Error thrown when this contract balance is less than sweep amount\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}]},\"events\":{\"DropFailedMessage(uint16,bytes,uint64)\":{\"notice\":\"Emits when stored message dropped without successful retrying.\"},\"InnerTokenAdded(address)\":{\"notice\":\"Event emitted when inner token set successfully.\"},\"OracleChanged(address,address)\":{\"notice\":\"Event emitted when oracle is modified.\"},\"SetMaxDailyLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum daily limit of transactions from local chain is modified.\"},\"SetMaxDailyReceiveLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\"},\"SetMaxSingleReceiveTransactionLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum limit for a single receive transaction from remote chain is modified.\"},\"SetMaxSingleTransactionLimit(uint16,uint256,uint256)\":{\"notice\":\"Emitted when the maximum limit for a single transaction from local chain is modified.\"},\"SetWhitelist(address,bool)\":{\"notice\":\"Emitted when address is added to whitelist.\"},\"SweepToken(address,address,uint256)\":{\"notice\":\"Emitted on sweep token success\"},\"TrustedRemoteRemoved(uint16)\":{\"notice\":\"Event emitted when trusted remote sets to empty.\"},\"UpdateSendAndCallEnabled(bool)\":{\"notice\":\"Event emitted when SendAndCallEnabled updated successfully.\"}},\"kind\":\"user\",\"methods\":{\"chainIdToLast24HourReceiveWindowStart(uint16)\":{\"notice\":\"Timestamp when the last 24-hour window started from remote chain.\"},\"chainIdToLast24HourReceived(uint16)\":{\"notice\":\"Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\"},\"chainIdToLast24HourTransferred(uint16)\":{\"notice\":\"Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\"},\"chainIdToLast24HourWindowStart(uint16)\":{\"notice\":\"Timestamp when the last 24-hour window started from local chain.\"},\"chainIdToMaxDailyLimit(uint16)\":{\"notice\":\"Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\"},\"chainIdToMaxDailyReceiveLimit(uint16)\":{\"notice\":\"Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\"},\"chainIdToMaxSingleReceiveTransactionLimit(uint16)\":{\"notice\":\"Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\"},\"chainIdToMaxSingleTransactionLimit(uint16)\":{\"notice\":\"Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\"},\"circulatingSupply()\":{\"notice\":\"Returns the total circulating supply of the token on the destination chain i.e (total supply).\"},\"dropFailedMessage(uint16,bytes,uint64)\":{\"notice\":\"Clear failed messages from the storage.\"},\"isEligibleToSend(address,uint16,uint256)\":{\"notice\":\"Checks the eligibility of a sender to initiate a cross-chain token transfer.\"},\"oracle()\":{\"notice\":\"The address of ResilientOracle contract wrapped in its interface.\"},\"pause()\":{\"notice\":\"Triggers stopped state of the bridge.\"},\"removeTrustedRemote(uint16)\":{\"notice\":\"Remove trusted remote from storage.\"},\"renounceOwnership()\":{\"notice\":\"Empty implementation of renounce ownership to avoid any mishappening.\"},\"sendAndCall(address,uint16,bytes32,uint256,bytes,uint64,(address,address,bytes))\":{\"notice\":\"Initiates a cross-chain token transfer and triggers a call on the destination chain.\"},\"setMaxDailyLimit(uint16,uint256)\":{\"notice\":\"Sets the limit of daily (24 Hour) transactions amount.\"},\"setMaxDailyReceiveLimit(uint16,uint256)\":{\"notice\":\"Sets the maximum daily limit for receiving transactions.\"},\"setMaxSingleReceiveTransactionLimit(uint16,uint256)\":{\"notice\":\"Sets the maximum limit for a single receive transaction.\"},\"setMaxSingleTransactionLimit(uint16,uint256)\":{\"notice\":\"Sets the limit of single transaction amount.\"},\"setOracle(address)\":{\"notice\":\"Set the address of the ResilientOracle contract.\"},\"setWhitelist(address,bool)\":{\"notice\":\"Sets the whitelist address to skip checks on transaction limit.\"},\"sweepToken(address,address,uint256)\":{\"notice\":\"A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\"},\"token()\":{\"notice\":\"Return's the address of the inner token of this bridge.\"},\"unpause()\":{\"notice\":\"Triggers resume state of the bridge.\"},\"updateSendAndCallEnabled(bool)\":{\"notice\":\"It enables or disables sendAndCall functionality for the bridge.\"},\"whitelist(address)\":{\"notice\":\"Address on which cap check and bound limit is not applicable.\"}},\"notice\":\"XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT, and focuses on managing token transfers to the destination chain. It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/Bridge/XVSProxyOFTDest.sol\":\"XVSProxyOFTDest\"},\"evmVersion\":\"paris\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@layerzerolabs/solidity-examples/contracts/libraries/BytesLib.sol\":{\"content\":\"// SPDX-License-Identifier: Unlicense\\n/*\\n * @title Solidity Bytes Arrays Utils\\n * @author Gon\\u00e7alo S\\u00e1 \\n *\\n * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.\\n * The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.\\n */\\npragma solidity >=0.8.0 <0.9.0;\\n\\nlibrary BytesLib {\\n function concat(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bytes memory) {\\n bytes memory tempBytes;\\n\\n assembly {\\n // Get a location of some free memory and store it in tempBytes as\\n // Solidity does for memory variables.\\n tempBytes := mload(0x40)\\n\\n // Store the length of the first bytes array at the beginning of\\n // the memory for tempBytes.\\n let length := mload(_preBytes)\\n mstore(tempBytes, length)\\n\\n // Maintain a memory counter for the current write location in the\\n // temp bytes array by adding the 32 bytes for the array length to\\n // the starting location.\\n let mc := add(tempBytes, 0x20)\\n // Stop copying when the memory counter reaches the length of the\\n // first bytes array.\\n let end := add(mc, length)\\n\\n for {\\n // Initialize a copy counter to the start of the _preBytes data,\\n // 32 bytes into its memory.\\n let cc := add(_preBytes, 0x20)\\n } lt(mc, end) {\\n // Increase both counters by 32 bytes each iteration.\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n // Write the _preBytes data into the tempBytes memory 32 bytes\\n // at a time.\\n mstore(mc, mload(cc))\\n }\\n\\n // Add the length of _postBytes to the current length of tempBytes\\n // and store it as the new length in the first 32 bytes of the\\n // tempBytes memory.\\n length := mload(_postBytes)\\n mstore(tempBytes, add(length, mload(tempBytes)))\\n\\n // Move the memory counter back from a multiple of 0x20 to the\\n // actual end of the _preBytes data.\\n mc := end\\n // Stop copying when the memory counter reaches the new combined\\n // length of the arrays.\\n end := add(mc, length)\\n\\n for {\\n let cc := add(_postBytes, 0x20)\\n } lt(mc, end) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n mstore(mc, mload(cc))\\n }\\n\\n // Update the free-memory pointer by padding our last write location\\n // to 32 bytes: add 31 bytes to the end of tempBytes to move to the\\n // next 32 byte block, then round down to the nearest multiple of\\n // 32. If the sum of the length of the two arrays is zero then add\\n // one before rounding down to leave a blank 32 bytes (the length block with 0).\\n mstore(\\n 0x40,\\n and(\\n add(add(end, iszero(add(length, mload(_preBytes)))), 31),\\n not(31) // Round down to the nearest 32 bytes.\\n )\\n )\\n }\\n\\n return tempBytes;\\n }\\n\\n function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {\\n assembly {\\n // Read the first 32 bytes of _preBytes storage, which is the length\\n // of the array. (We don't need to use the offset into the slot\\n // because arrays use the entire slot.)\\n let fslot := sload(_preBytes.slot)\\n // Arrays of 31 bytes or less have an even value in their slot,\\n // while longer arrays have an odd value. The actual length is\\n // the slot divided by two for odd values, and the lowest order\\n // byte divided by two for even values.\\n // If the slot is even, bitwise and the slot with 255 and divide by\\n // two to get the length. If the slot is odd, bitwise and the slot\\n // with -1 and divide by two.\\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\\n let mlength := mload(_postBytes)\\n let newlength := add(slength, mlength)\\n // slength can contain both the length and contents of the array\\n // if length < 32 bytes so let's prepare for that\\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\\n switch add(lt(slength, 32), lt(newlength, 32))\\n case 2 {\\n // Since the new array still fits in the slot, we just need to\\n // update the contents of the slot.\\n // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length\\n sstore(\\n _preBytes.slot,\\n // all the modifications to the slot are inside this\\n // next block\\n add(\\n // we can just add to the slot contents because the\\n // bytes we want to change are the LSBs\\n fslot,\\n add(\\n mul(\\n div(\\n // load the bytes from memory\\n mload(add(_postBytes, 0x20)),\\n // zero all bytes to the right\\n exp(0x100, sub(32, mlength))\\n ),\\n // and now shift left the number of bytes to\\n // leave space for the length in the slot\\n exp(0x100, sub(32, newlength))\\n ),\\n // increase length by the double of the memory\\n // bytes length\\n mul(mlength, 2)\\n )\\n )\\n )\\n }\\n case 1 {\\n // The stored value fits in the slot, but the combined value\\n // will exceed it.\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\\n\\n // save new length\\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\\n\\n // The contents of the _postBytes array start 32 bytes into\\n // the structure. Our first read should obtain the `submod`\\n // bytes that can fit into the unused space in the last word\\n // of the stored array. To get this, we read 32 bytes starting\\n // from `submod`, so the data we read overlaps with the array\\n // contents by `submod` bytes. Masking the lowest-order\\n // `submod` bytes allows us to add that value directly to the\\n // stored value.\\n\\n let submod := sub(32, slength)\\n let mc := add(_postBytes, submod)\\n let end := add(_postBytes, mlength)\\n let mask := sub(exp(0x100, submod), 1)\\n\\n sstore(sc, add(and(fslot, 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00), and(mload(mc), mask)))\\n\\n for {\\n mc := add(mc, 0x20)\\n sc := add(sc, 1)\\n } lt(mc, end) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n sstore(sc, mload(mc))\\n }\\n\\n mask := exp(0x100, sub(mc, end))\\n\\n sstore(sc, mul(div(mload(mc), mask), mask))\\n }\\n default {\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n // Start copying to the last used word of the stored array.\\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\\n\\n // save new length\\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\\n\\n // Copy over the first `submod` bytes of the new data as in\\n // case 1 above.\\n let slengthmod := mod(slength, 32)\\n let mlengthmod := mod(mlength, 32)\\n let submod := sub(32, slengthmod)\\n let mc := add(_postBytes, submod)\\n let end := add(_postBytes, mlength)\\n let mask := sub(exp(0x100, submod), 1)\\n\\n sstore(sc, add(sload(sc), and(mload(mc), mask)))\\n\\n for {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } lt(mc, end) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n sstore(sc, mload(mc))\\n }\\n\\n mask := exp(0x100, sub(mc, end))\\n\\n sstore(sc, mul(div(mload(mc), mask), mask))\\n }\\n }\\n }\\n\\n function slice(\\n bytes memory _bytes,\\n uint _start,\\n uint _length\\n ) internal pure returns (bytes memory) {\\n require(_length + 31 >= _length, \\\"slice_overflow\\\");\\n require(_bytes.length >= _start + _length, \\\"slice_outOfBounds\\\");\\n\\n bytes memory tempBytes;\\n\\n assembly {\\n switch iszero(_length)\\n case 0 {\\n // Get a location of some free memory and store it in tempBytes as\\n // Solidity does for memory variables.\\n tempBytes := mload(0x40)\\n\\n // The first word of the slice result is potentially a partial\\n // word read from the original array. To read it, we calculate\\n // the length of that partial word and start copying that many\\n // bytes into the array. The first word we copy will start with\\n // data we don't care about, but the last `lengthmod` bytes will\\n // land at the beginning of the contents of the new array. When\\n // we're done copying, we overwrite the full first word with\\n // the actual length of the slice.\\n let lengthmod := and(_length, 31)\\n\\n // The multiplication in the next line is necessary\\n // because when slicing multiples of 32 bytes (lengthmod == 0)\\n // the following copy loop was copying the origin's length\\n // and then ending prematurely not copying everything it should.\\n let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))\\n let end := add(mc, _length)\\n\\n for {\\n // The multiplication in the next line has the same exact purpose\\n // as the one above.\\n let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)\\n } lt(mc, end) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n mstore(mc, mload(cc))\\n }\\n\\n mstore(tempBytes, _length)\\n\\n //update free-memory pointer\\n //allocating the array padded to 32 bytes like the compiler does now\\n mstore(0x40, and(add(mc, 31), not(31)))\\n }\\n //if we want a zero-length slice let's just return a zero-length array\\n default {\\n tempBytes := mload(0x40)\\n //zero out the 32 bytes slice we are about to return\\n //we need to do it because Solidity does not garbage collect\\n mstore(tempBytes, 0)\\n\\n mstore(0x40, add(tempBytes, 0x20))\\n }\\n }\\n\\n return tempBytes;\\n }\\n\\n function toAddress(bytes memory _bytes, uint _start) internal pure returns (address) {\\n require(_bytes.length >= _start + 20, \\\"toAddress_outOfBounds\\\");\\n address tempAddress;\\n\\n assembly {\\n tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)\\n }\\n\\n return tempAddress;\\n }\\n\\n function toUint8(bytes memory _bytes, uint _start) internal pure returns (uint8) {\\n require(_bytes.length >= _start + 1, \\\"toUint8_outOfBounds\\\");\\n uint8 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x1), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint16(bytes memory _bytes, uint _start) internal pure returns (uint16) {\\n require(_bytes.length >= _start + 2, \\\"toUint16_outOfBounds\\\");\\n uint16 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x2), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint32(bytes memory _bytes, uint _start) internal pure returns (uint32) {\\n require(_bytes.length >= _start + 4, \\\"toUint32_outOfBounds\\\");\\n uint32 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x4), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint64(bytes memory _bytes, uint _start) internal pure returns (uint64) {\\n require(_bytes.length >= _start + 8, \\\"toUint64_outOfBounds\\\");\\n uint64 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x8), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint96(bytes memory _bytes, uint _start) internal pure returns (uint96) {\\n require(_bytes.length >= _start + 12, \\\"toUint96_outOfBounds\\\");\\n uint96 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0xc), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint128(bytes memory _bytes, uint _start) internal pure returns (uint128) {\\n require(_bytes.length >= _start + 16, \\\"toUint128_outOfBounds\\\");\\n uint128 tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x10), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toUint256(bytes memory _bytes, uint _start) internal pure returns (uint) {\\n require(_bytes.length >= _start + 32, \\\"toUint256_outOfBounds\\\");\\n uint tempUint;\\n\\n assembly {\\n tempUint := mload(add(add(_bytes, 0x20), _start))\\n }\\n\\n return tempUint;\\n }\\n\\n function toBytes32(bytes memory _bytes, uint _start) internal pure returns (bytes32) {\\n require(_bytes.length >= _start + 32, \\\"toBytes32_outOfBounds\\\");\\n bytes32 tempBytes32;\\n\\n assembly {\\n tempBytes32 := mload(add(add(_bytes, 0x20), _start))\\n }\\n\\n return tempBytes32;\\n }\\n\\n function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {\\n bool success = true;\\n\\n assembly {\\n let length := mload(_preBytes)\\n\\n // if lengths don't match the arrays are not equal\\n switch eq(length, mload(_postBytes))\\n case 1 {\\n // cb is a circuit breaker in the for loop since there's\\n // no said feature for inline assembly loops\\n // cb = 1 - don't breaker\\n // cb = 0 - break\\n let cb := 1\\n\\n let mc := add(_preBytes, 0x20)\\n let end := add(mc, length)\\n\\n for {\\n let cc := add(_postBytes, 0x20)\\n // the next line is the loop condition:\\n // while(uint256(mc < end) + cb == 2)\\n } eq(add(lt(mc, end), cb), 2) {\\n mc := add(mc, 0x20)\\n cc := add(cc, 0x20)\\n } {\\n // if any of these checks fails then arrays are not equal\\n if iszero(eq(mload(mc), mload(cc))) {\\n // unsuccess:\\n success := 0\\n cb := 0\\n }\\n }\\n }\\n default {\\n // unsuccess:\\n success := 0\\n }\\n }\\n\\n return success;\\n }\\n\\n function equalStorage(bytes storage _preBytes, bytes memory _postBytes) internal view returns (bool) {\\n bool success = true;\\n\\n assembly {\\n // we know _preBytes_offset is 0\\n let fslot := sload(_preBytes.slot)\\n // Decode the length of the stored array like in concatStorage().\\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\\n let mlength := mload(_postBytes)\\n\\n // if lengths don't match the arrays are not equal\\n switch eq(slength, mlength)\\n case 1 {\\n // slength can contain both the length and contents of the array\\n // if length < 32 bytes so let's prepare for that\\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\\n if iszero(iszero(slength)) {\\n switch lt(slength, 32)\\n case 1 {\\n // blank the last byte which is the length\\n fslot := mul(div(fslot, 0x100), 0x100)\\n\\n if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {\\n // unsuccess:\\n success := 0\\n }\\n }\\n default {\\n // cb is a circuit breaker in the for loop since there's\\n // no said feature for inline assembly loops\\n // cb = 1 - don't breaker\\n // cb = 0 - break\\n let cb := 1\\n\\n // get the keccak hash to get the contents of the array\\n mstore(0x0, _preBytes.slot)\\n let sc := keccak256(0x0, 0x20)\\n\\n let mc := add(_postBytes, 0x20)\\n let end := add(mc, mlength)\\n\\n // the next line is the loop condition:\\n // while(uint256(mc < end) + cb == 2)\\n for {\\n\\n } eq(add(lt(mc, end), cb), 2) {\\n sc := add(sc, 1)\\n mc := add(mc, 0x20)\\n } {\\n if iszero(eq(sload(sc), mload(mc))) {\\n // unsuccess:\\n success := 0\\n cb := 0\\n }\\n }\\n }\\n }\\n }\\n default {\\n // unsuccess:\\n success := 0\\n }\\n }\\n\\n return success;\\n }\\n}\\n\",\"keccak256\":\"0x7e64cccdf22a03f513d94960f2145dd801fb5ec88d971de079b5186a9f5e93c4\",\"license\":\"Unlicense\"},\"@layerzerolabs/solidity-examples/contracts/libraries/ExcessivelySafeCall.sol\":{\"content\":\"// SPDX-License-Identifier: MIT OR Apache-2.0\\npragma solidity >=0.7.6;\\n\\nlibrary ExcessivelySafeCall {\\n uint constant LOW_28_MASK = 0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;\\n\\n /// @notice Use when you _really_ really _really_ don't trust the called\\n /// contract. This prevents the called contract from causing reversion of\\n /// the caller in as many ways as we can.\\n /// @dev The main difference between this and a solidity low-level call is\\n /// that we limit the number of bytes that the callee can cause to be\\n /// copied to caller memory. This prevents stupid things like malicious\\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\\n /// to memory.\\n /// @param _target The address to call\\n /// @param _gas The amount of gas to forward to the remote contract\\n /// @param _maxCopy The maximum number of bytes of returndata to copy\\n /// to memory.\\n /// @param _calldata The data to send to the remote contract\\n /// @return success and returndata, as `.call()`. Returndata is capped to\\n /// `_maxCopy` bytes.\\n function excessivelySafeCall(\\n address _target,\\n uint _gas,\\n uint16 _maxCopy,\\n bytes memory _calldata\\n ) internal returns (bool, bytes memory) {\\n // set up for assembly call\\n uint _toCopy;\\n bool _success;\\n bytes memory _returnData = new bytes(_maxCopy);\\n // dispatch message to recipient\\n // by assembly calling \\\"handle\\\" function\\n // we call via assembly to avoid memcopying a very large returndata\\n // returned by a malicious contract\\n assembly {\\n _success := call(\\n _gas, // gas\\n _target, // recipient\\n 0, // ether value\\n add(_calldata, 0x20), // inloc\\n mload(_calldata), // inlen\\n 0, // outloc\\n 0 // outlen\\n )\\n // limit our copy to 256 bytes\\n _toCopy := returndatasize()\\n if gt(_toCopy, _maxCopy) {\\n _toCopy := _maxCopy\\n }\\n // Store the length of the copied bytes\\n mstore(_returnData, _toCopy)\\n // copy the bytes from returndata[0:_toCopy]\\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\\n }\\n return (_success, _returnData);\\n }\\n\\n /// @notice Use when you _really_ really _really_ don't trust the called\\n /// contract. This prevents the called contract from causing reversion of\\n /// the caller in as many ways as we can.\\n /// @dev The main difference between this and a solidity low-level call is\\n /// that we limit the number of bytes that the callee can cause to be\\n /// copied to caller memory. This prevents stupid things like malicious\\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\\n /// to memory.\\n /// @param _target The address to call\\n /// @param _gas The amount of gas to forward to the remote contract\\n /// @param _maxCopy The maximum number of bytes of returndata to copy\\n /// to memory.\\n /// @param _calldata The data to send to the remote contract\\n /// @return success and returndata, as `.call()`. Returndata is capped to\\n /// `_maxCopy` bytes.\\n function excessivelySafeStaticCall(\\n address _target,\\n uint _gas,\\n uint16 _maxCopy,\\n bytes memory _calldata\\n ) internal view returns (bool, bytes memory) {\\n // set up for assembly call\\n uint _toCopy;\\n bool _success;\\n bytes memory _returnData = new bytes(_maxCopy);\\n // dispatch message to recipient\\n // by assembly calling \\\"handle\\\" function\\n // we call via assembly to avoid memcopying a very large returndata\\n // returned by a malicious contract\\n assembly {\\n _success := staticcall(\\n _gas, // gas\\n _target, // recipient\\n add(_calldata, 0x20), // inloc\\n mload(_calldata), // inlen\\n 0, // outloc\\n 0 // outlen\\n )\\n // limit our copy to 256 bytes\\n _toCopy := returndatasize()\\n if gt(_toCopy, _maxCopy) {\\n _toCopy := _maxCopy\\n }\\n // Store the length of the copied bytes\\n mstore(_returnData, _toCopy)\\n // copy the bytes from returndata[0:_toCopy]\\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\\n }\\n return (_success, _returnData);\\n }\\n\\n /**\\n * @notice Swaps function selectors in encoded contract calls\\n * @dev Allows reuse of encoded calldata for functions with identical\\n * argument types but different names. It simply swaps out the first 4 bytes\\n * for the new selector. This function modifies memory in place, and should\\n * only be used with caution.\\n * @param _newSelector The new 4-byte selector\\n * @param _buf The encoded contract args\\n */\\n function swapSelector(bytes4 _newSelector, bytes memory _buf) internal pure {\\n require(_buf.length >= 4);\\n uint _mask = LOW_28_MASK;\\n assembly {\\n // load the first word of\\n let _word := mload(add(_buf, 0x20))\\n // mask out the top 4 bytes\\n // /x\\n _word := and(_word, _mask)\\n _word := or(_newSelector, _word)\\n mstore(add(_buf, 0x20), _word)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xd4e52af409b5ec80432292d86fb01906785eb78ac31da3bab4565aabcd6e3e56\",\"license\":\"MIT OR Apache-2.0\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/LzApp.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\nimport \\\"./interfaces/ILayerZeroReceiver.sol\\\";\\nimport \\\"./interfaces/ILayerZeroUserApplicationConfig.sol\\\";\\nimport \\\"./interfaces/ILayerZeroEndpoint.sol\\\";\\nimport \\\"../libraries/BytesLib.sol\\\";\\n\\n/*\\n * a generic LzReceiver implementation\\n */\\nabstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {\\n using BytesLib for bytes;\\n\\n // ua can not send payload larger than this by default, but it can be changed by the ua owner\\n uint public constant DEFAULT_PAYLOAD_SIZE_LIMIT = 10000;\\n\\n ILayerZeroEndpoint public immutable lzEndpoint;\\n mapping(uint16 => bytes) public trustedRemoteLookup;\\n mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;\\n mapping(uint16 => uint) public payloadSizeLimitLookup;\\n address public precrime;\\n\\n event SetPrecrime(address precrime);\\n event SetTrustedRemote(uint16 _remoteChainId, bytes _path);\\n event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);\\n event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);\\n\\n constructor(address _endpoint) {\\n lzEndpoint = ILayerZeroEndpoint(_endpoint);\\n }\\n\\n function lzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public virtual override {\\n // lzReceive must be called by the endpoint for security\\n require(_msgSender() == address(lzEndpoint), \\\"LzApp: invalid endpoint caller\\\");\\n\\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\\n // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\\n require(\\n _srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote),\\n \\\"LzApp: invalid source sending contract\\\"\\n );\\n\\n _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging\\n function _blockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual;\\n\\n function _lzSend(\\n uint16 _dstChainId,\\n bytes memory _payload,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams,\\n uint _nativeFee\\n ) internal virtual {\\n bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];\\n require(trustedRemote.length != 0, \\\"LzApp: destination chain is not a trusted source\\\");\\n _checkPayloadSize(_dstChainId, _payload.length);\\n lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);\\n }\\n\\n function _checkGasLimit(\\n uint16 _dstChainId,\\n uint16 _type,\\n bytes memory _adapterParams,\\n uint _extraGas\\n ) internal view virtual {\\n uint providedGasLimit = _getGasLimit(_adapterParams);\\n uint minGasLimit = minDstGasLookup[_dstChainId][_type];\\n require(minGasLimit > 0, \\\"LzApp: minGasLimit not set\\\");\\n require(providedGasLimit >= minGasLimit + _extraGas, \\\"LzApp: gas limit is too low\\\");\\n }\\n\\n function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {\\n require(_adapterParams.length >= 34, \\\"LzApp: invalid adapterParams\\\");\\n assembly {\\n gasLimit := mload(add(_adapterParams, 34))\\n }\\n }\\n\\n function _checkPayloadSize(uint16 _dstChainId, uint _payloadSize) internal view virtual {\\n uint payloadSizeLimit = payloadSizeLimitLookup[_dstChainId];\\n if (payloadSizeLimit == 0) {\\n // use default if not set\\n payloadSizeLimit = DEFAULT_PAYLOAD_SIZE_LIMIT;\\n }\\n require(_payloadSize <= payloadSizeLimit, \\\"LzApp: payload size is too large\\\");\\n }\\n\\n //---------------------------UserApplication config----------------------------------------\\n function getConfig(\\n uint16 _version,\\n uint16 _chainId,\\n address,\\n uint _configType\\n ) external view returns (bytes memory) {\\n return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);\\n }\\n\\n // generic config for LayerZero user Application\\n function setConfig(\\n uint16 _version,\\n uint16 _chainId,\\n uint _configType,\\n bytes calldata _config\\n ) external override onlyOwner {\\n lzEndpoint.setConfig(_version, _chainId, _configType, _config);\\n }\\n\\n function setSendVersion(uint16 _version) external override onlyOwner {\\n lzEndpoint.setSendVersion(_version);\\n }\\n\\n function setReceiveVersion(uint16 _version) external override onlyOwner {\\n lzEndpoint.setReceiveVersion(_version);\\n }\\n\\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {\\n lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);\\n }\\n\\n // _path = abi.encodePacked(remoteAddress, localAddress)\\n // this function set the trusted path for the cross-chain communication\\n function setTrustedRemote(uint16 _remoteChainId, bytes calldata _path) external onlyOwner {\\n trustedRemoteLookup[_remoteChainId] = _path;\\n emit SetTrustedRemote(_remoteChainId, _path);\\n }\\n\\n function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {\\n trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));\\n emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);\\n }\\n\\n function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {\\n bytes memory path = trustedRemoteLookup[_remoteChainId];\\n require(path.length != 0, \\\"LzApp: no trusted path record\\\");\\n return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)\\n }\\n\\n function setPrecrime(address _precrime) external onlyOwner {\\n precrime = _precrime;\\n emit SetPrecrime(_precrime);\\n }\\n\\n function setMinDstGas(\\n uint16 _dstChainId,\\n uint16 _packetType,\\n uint _minGas\\n ) external onlyOwner {\\n minDstGasLookup[_dstChainId][_packetType] = _minGas;\\n emit SetMinDstGas(_dstChainId, _packetType, _minGas);\\n }\\n\\n // if the size is 0, it means default size limit\\n function setPayloadSizeLimit(uint16 _dstChainId, uint _size) external onlyOwner {\\n payloadSizeLimitLookup[_dstChainId] = _size;\\n }\\n\\n //--------------------------- VIEW FUNCTION ----------------------------------------\\n function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {\\n bytes memory trustedSource = trustedRemoteLookup[_srcChainId];\\n return keccak256(trustedSource) == keccak256(_srcAddress);\\n }\\n}\\n\",\"keccak256\":\"0x309c994bdcf69ad63c6789694a28eb72a773e2d9db58fe572ab2b34a475972ce\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/NonblockingLzApp.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./LzApp.sol\\\";\\nimport \\\"../libraries/ExcessivelySafeCall.sol\\\";\\n\\n/*\\n * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel\\n * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking\\n * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)\\n */\\nabstract contract NonblockingLzApp is LzApp {\\n using ExcessivelySafeCall for address;\\n\\n constructor(address _endpoint) LzApp(_endpoint) {}\\n\\n mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;\\n\\n event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);\\n event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);\\n\\n // overriding the virtual function in LzReceiver\\n function _blockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual override {\\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\\n gasleft(),\\n 150,\\n abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload)\\n );\\n // try-catch all errors/exceptions\\n if (!success) {\\n _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);\\n }\\n }\\n\\n function _storeFailedMessage(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload,\\n bytes memory _reason\\n ) internal virtual {\\n failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);\\n emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);\\n }\\n\\n function nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public virtual {\\n // only internal transaction\\n require(_msgSender() == address(this), \\\"NonblockingLzApp: caller must be LzApp\\\");\\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n //@notice override this function\\n function _nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual;\\n\\n function retryMessage(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public payable virtual {\\n // assert there is message to retry\\n bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];\\n require(payloadHash != bytes32(0), \\\"NonblockingLzApp: no stored message\\\");\\n require(keccak256(_payload) == payloadHash, \\\"NonblockingLzApp: invalid payload\\\");\\n // clear the stored message\\n failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);\\n // execute the message. revert if it fails again\\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\\n emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);\\n }\\n}\\n\",\"keccak256\":\"0x612ff1f2a158b7e64e873885b5ff08afa348998fd9005f384d555d643ba7968d\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroEndpoint.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"./ILayerZeroUserApplicationConfig.sol\\\";\\n\\ninterface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {\\n // @notice send a LayerZero message to the specified address at a LayerZero endpoint.\\n // @param _dstChainId - the destination chain identifier\\n // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains\\n // @param _payload - a custom bytes payload to send to the destination contract\\n // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address\\n // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction\\n // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination\\n function send(\\n uint16 _dstChainId,\\n bytes calldata _destination,\\n bytes calldata _payload,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes calldata _adapterParams\\n ) external payable;\\n\\n // @notice used by the messaging library to publish verified payload\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source contract (as bytes) at the source chain\\n // @param _dstAddress - the address on destination chain\\n // @param _nonce - the unbound message ordering nonce\\n // @param _gasLimit - the gas limit for external contract execution\\n // @param _payload - verified payload to send to the destination contract\\n function receivePayload(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n address _dstAddress,\\n uint64 _nonce,\\n uint _gasLimit,\\n bytes calldata _payload\\n ) external;\\n\\n // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);\\n\\n // @notice get the outboundNonce from this source chain which, consequently, is always an EVM\\n // @param _srcAddress - the source chain contract address\\n function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);\\n\\n // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery\\n // @param _dstChainId - the destination chain identifier\\n // @param _userApplication - the user app address on this EVM chain\\n // @param _payload - the custom message to send over LayerZero\\n // @param _payInZRO - if false, user app pays the protocol fee in native token\\n // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain\\n function estimateFees(\\n uint16 _dstChainId,\\n address _userApplication,\\n bytes calldata _payload,\\n bool _payInZRO,\\n bytes calldata _adapterParam\\n ) external view returns (uint nativeFee, uint zroFee);\\n\\n // @notice get this Endpoint's immutable source identifier\\n function getChainId() external view returns (uint16);\\n\\n // @notice the interface to retry failed message on this Endpoint destination\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n // @param _payload - the payload to be retried\\n function retryPayload(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n bytes calldata _payload\\n ) external;\\n\\n // @notice query if any STORED payload (message blocking) at the endpoint.\\n // @param _srcChainId - the source chain identifier\\n // @param _srcAddress - the source chain contract address\\n function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);\\n\\n // @notice query if the _libraryAddress is valid for sending msgs.\\n // @param _userApplication - the user app address on this EVM chain\\n function getSendLibraryAddress(address _userApplication) external view returns (address);\\n\\n // @notice query if the _libraryAddress is valid for receiving msgs.\\n // @param _userApplication - the user app address on this EVM chain\\n function getReceiveLibraryAddress(address _userApplication) external view returns (address);\\n\\n // @notice query if the non-reentrancy guard for send() is on\\n // @return true if the guard is on. false otherwise\\n function isSendingPayload() external view returns (bool);\\n\\n // @notice query if the non-reentrancy guard for receive() is on\\n // @return true if the guard is on. false otherwise\\n function isReceivingPayload() external view returns (bool);\\n\\n // @notice get the configuration of the LayerZero messaging library of the specified version\\n // @param _version - messaging library version\\n // @param _chainId - the chainId for the pending config change\\n // @param _userApplication - the contract address of the user application\\n // @param _configType - type of configuration. every messaging library has its own convention.\\n function getConfig(\\n uint16 _version,\\n uint16 _chainId,\\n address _userApplication,\\n uint _configType\\n ) external view returns (bytes memory);\\n\\n // @notice get the send() LayerZero messaging library version\\n // @param _userApplication - the contract address of the user application\\n function getSendVersion(address _userApplication) external view returns (uint16);\\n\\n // @notice get the lzReceive() LayerZero messaging library version\\n // @param _userApplication - the contract address of the user application\\n function getReceiveVersion(address _userApplication) external view returns (uint16);\\n}\\n\",\"keccak256\":\"0xab7fcacc672251c850f00c0abd4100df9afcc4ad70b8d331a2fd4cb07acab9f4\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroReceiver.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\ninterface ILayerZeroReceiver {\\n // @notice LayerZero endpoint will invoke this function to deliver the message on the destination\\n // @param _srcChainId - the source endpoint identifier\\n // @param _srcAddress - the source sending contract address from the source chain\\n // @param _nonce - the ordered message nonce\\n // @param _payload - the signed payload is the UA bytes has encoded to be sent\\n function lzReceive(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) external;\\n}\\n\",\"keccak256\":\"0xac1966c1229bd4dc36b6c69eeb94a537bd9aa2198d7623b9ba7f8f7dbe79bb4c\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroUserApplicationConfig.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\ninterface ILayerZeroUserApplicationConfig {\\n // @notice set the configuration of the LayerZero messaging library of the specified version\\n // @param _version - messaging library version\\n // @param _chainId - the chainId for the pending config change\\n // @param _configType - type of configuration. every messaging library has its own convention.\\n // @param _config - configuration in the bytes. can encode arbitrary content.\\n function setConfig(\\n uint16 _version,\\n uint16 _chainId,\\n uint _configType,\\n bytes calldata _config\\n ) external;\\n\\n // @notice set the send() LayerZero messaging library version to _version\\n // @param _version - new messaging library version\\n function setSendVersion(uint16 _version) external;\\n\\n // @notice set the lzReceive() LayerZero messaging library version to _version\\n // @param _version - new messaging library version\\n function setReceiveVersion(uint16 _version) external;\\n\\n // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload\\n // @param _srcChainId - the chainId of the source chain\\n // @param _srcAddress - the contract address of the source contract at the source chain\\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;\\n}\\n\",\"keccak256\":\"0xb4df93aeb0fb46373a4fb728ad2603edc8b9a1577eee8d801768dc115bf96498\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OFTCoreV2.sol\\\";\\nimport \\\"./interfaces/IOFTV2.sol\\\";\\nimport \\\"@openzeppelin/contracts/utils/introspection/ERC165.sol\\\";\\n\\nabstract contract BaseOFTV2 is OFTCoreV2, ERC165, IOFTV2 {\\n constructor(uint8 _sharedDecimals, address _lzEndpoint) OFTCoreV2(_sharedDecimals, _lzEndpoint) {}\\n\\n /************************************************************************\\n * public functions\\n ************************************************************************/\\n function sendFrom(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n LzCallParams calldata _callParams\\n ) public payable virtual override {\\n _send(_from, _dstChainId, _toAddress, _amount, _callParams.refundAddress, _callParams.zroPaymentAddress, _callParams.adapterParams);\\n }\\n\\n function sendAndCall(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes calldata _payload,\\n uint64 _dstGasForCall,\\n LzCallParams calldata _callParams\\n ) public payable virtual override {\\n _sendAndCall(\\n _from,\\n _dstChainId,\\n _toAddress,\\n _amount,\\n _payload,\\n _dstGasForCall,\\n _callParams.refundAddress,\\n _callParams.zroPaymentAddress,\\n _callParams.adapterParams\\n );\\n }\\n\\n /************************************************************************\\n * public view functions\\n ************************************************************************/\\n function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {\\n return interfaceId == type(IOFTV2).interfaceId || super.supportsInterface(interfaceId);\\n }\\n\\n function estimateSendFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bool _useZro,\\n bytes calldata _adapterParams\\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\\n return _estimateSendFee(_dstChainId, _toAddress, _amount, _useZro, _adapterParams);\\n }\\n\\n function estimateSendAndCallFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes calldata _payload,\\n uint64 _dstGasForCall,\\n bool _useZro,\\n bytes calldata _adapterParams\\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\\n return _estimateSendAndCallFee(_dstChainId, _toAddress, _amount, _payload, _dstGasForCall, _useZro, _adapterParams);\\n }\\n\\n function circulatingSupply() public view virtual override returns (uint);\\n\\n function token() public view virtual override returns (address);\\n}\\n\",\"keccak256\":\"0x59d2d32dd14a4f58232b126a7d69608a85f82137bd56d8ce0fc28ff646cba943\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/OFTCoreV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../../../lzApp/NonblockingLzApp.sol\\\";\\nimport \\\"../../../libraries/ExcessivelySafeCall.sol\\\";\\nimport \\\"./interfaces/ICommonOFT.sol\\\";\\nimport \\\"./interfaces/IOFTReceiverV2.sol\\\";\\n\\nabstract contract OFTCoreV2 is NonblockingLzApp {\\n using BytesLib for bytes;\\n using ExcessivelySafeCall for address;\\n\\n uint public constant NO_EXTRA_GAS = 0;\\n\\n // packet type\\n uint8 public constant PT_SEND = 0;\\n uint8 public constant PT_SEND_AND_CALL = 1;\\n\\n uint8 public immutable sharedDecimals;\\n\\n mapping(uint16 => mapping(bytes => mapping(uint64 => bool))) public creditedPackets;\\n\\n /**\\n * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)\\n * `_nonce` is the outbound nonce\\n */\\n event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes32 indexed _toAddress, uint _amount);\\n\\n /**\\n * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.\\n * `_nonce` is the inbound nonce.\\n */\\n event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);\\n\\n event CallOFTReceivedSuccess(uint16 indexed _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _hash);\\n\\n event NonContractAddress(address _address);\\n\\n // _sharedDecimals should be the minimum decimals on all chains\\n constructor(uint8 _sharedDecimals, address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {\\n sharedDecimals = _sharedDecimals;\\n }\\n\\n /************************************************************************\\n * public functions\\n ************************************************************************/\\n function callOnOFTReceived(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes32 _from,\\n address _to,\\n uint _amount,\\n bytes calldata _payload,\\n uint _gasForCall\\n ) public virtual {\\n require(_msgSender() == address(this), \\\"OFTCore: caller must be OFTCore\\\");\\n\\n // send\\n _amount = _transferFrom(address(this), _to, _amount);\\n emit ReceiveFromChain(_srcChainId, _to, _amount);\\n\\n // call\\n IOFTReceiverV2(_to).onOFTReceived{gas: _gasForCall}(_srcChainId, _srcAddress, _nonce, _from, _amount, _payload);\\n }\\n\\n /************************************************************************\\n * internal functions\\n ************************************************************************/\\n function _estimateSendFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bool _useZro,\\n bytes memory _adapterParams\\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\\n // mock the payload for sendFrom()\\n bytes memory payload = _encodeSendPayload(_toAddress, _ld2sd(_amount));\\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\\n }\\n\\n function _estimateSendAndCallFee(\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes memory _payload,\\n uint64 _dstGasForCall,\\n bool _useZro,\\n bytes memory _adapterParams\\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\\n // mock the payload for sendAndCall()\\n bytes memory payload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(_amount), _payload, _dstGasForCall);\\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\\n }\\n\\n function _nonblockingLzReceive(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual override {\\n uint8 packetType = _payload.toUint8(0);\\n\\n if (packetType == PT_SEND) {\\n _sendAck(_srcChainId, _srcAddress, _nonce, _payload);\\n } else if (packetType == PT_SEND_AND_CALL) {\\n _sendAndCallAck(_srcChainId, _srcAddress, _nonce, _payload);\\n } else {\\n revert(\\\"OFTCore: unknown packet type\\\");\\n }\\n }\\n\\n function _send(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams\\n ) internal virtual returns (uint amount) {\\n _checkGasLimit(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);\\n\\n (amount, ) = _removeDust(_amount);\\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount); // amount returned should not have dust\\n require(amount > 0, \\\"OFTCore: amount too small\\\");\\n\\n bytes memory lzPayload = _encodeSendPayload(_toAddress, _ld2sd(amount));\\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\\n\\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\\n }\\n\\n function _sendAck(\\n uint16 _srcChainId,\\n bytes memory,\\n uint64,\\n bytes memory _payload\\n ) internal virtual {\\n (address to, uint64 amountSD) = _decodeSendPayload(_payload);\\n if (to == address(0)) {\\n to = address(0xdead);\\n }\\n\\n uint amount = _sd2ld(amountSD);\\n amount = _creditTo(_srcChainId, to, amount);\\n\\n emit ReceiveFromChain(_srcChainId, to, amount);\\n }\\n\\n function _sendAndCall(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount,\\n bytes memory _payload,\\n uint64 _dstGasForCall,\\n address payable _refundAddress,\\n address _zroPaymentAddress,\\n bytes memory _adapterParams\\n ) internal virtual returns (uint amount) {\\n _checkGasLimit(_dstChainId, PT_SEND_AND_CALL, _adapterParams, _dstGasForCall);\\n\\n (amount, ) = _removeDust(_amount);\\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount);\\n require(amount > 0, \\\"OFTCore: amount too small\\\");\\n\\n // encode the msg.sender into the payload instead of _from\\n bytes memory lzPayload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(amount), _payload, _dstGasForCall);\\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\\n\\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\\n }\\n\\n function _sendAndCallAck(\\n uint16 _srcChainId,\\n bytes memory _srcAddress,\\n uint64 _nonce,\\n bytes memory _payload\\n ) internal virtual {\\n (bytes32 from, address to, uint64 amountSD, bytes memory payloadForCall, uint64 gasForCall) = _decodeSendAndCallPayload(_payload);\\n\\n bool credited = creditedPackets[_srcChainId][_srcAddress][_nonce];\\n uint amount = _sd2ld(amountSD);\\n\\n // credit to this contract first, and then transfer to receiver only if callOnOFTReceived() succeeds\\n if (!credited) {\\n amount = _creditTo(_srcChainId, address(this), amount);\\n creditedPackets[_srcChainId][_srcAddress][_nonce] = true;\\n }\\n\\n if (!_isContract(to)) {\\n emit NonContractAddress(to);\\n return;\\n }\\n\\n // workaround for stack too deep\\n uint16 srcChainId = _srcChainId;\\n bytes memory srcAddress = _srcAddress;\\n uint64 nonce = _nonce;\\n bytes memory payload = _payload;\\n bytes32 from_ = from;\\n address to_ = to;\\n uint amount_ = amount;\\n bytes memory payloadForCall_ = payloadForCall;\\n\\n // no gas limit for the call if retry\\n uint gas = credited ? gasleft() : gasForCall;\\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\\n gasleft(),\\n 150,\\n abi.encodeWithSelector(this.callOnOFTReceived.selector, srcChainId, srcAddress, nonce, from_, to_, amount_, payloadForCall_, gas)\\n );\\n\\n if (success) {\\n bytes32 hash = keccak256(payload);\\n emit CallOFTReceivedSuccess(srcChainId, srcAddress, nonce, hash);\\n } else {\\n // store the failed message into the nonblockingLzApp\\n _storeFailedMessage(srcChainId, srcAddress, nonce, payload, reason);\\n }\\n }\\n\\n function _isContract(address _account) internal view returns (bool) {\\n return _account.code.length > 0;\\n }\\n\\n function _ld2sd(uint _amount) internal view virtual returns (uint64) {\\n uint amountSD = _amount / _ld2sdRate();\\n require(amountSD <= type(uint64).max, \\\"OFTCore: amountSD overflow\\\");\\n return uint64(amountSD);\\n }\\n\\n function _sd2ld(uint64 _amountSD) internal view virtual returns (uint) {\\n return _amountSD * _ld2sdRate();\\n }\\n\\n function _removeDust(uint _amount) internal view virtual returns (uint amountAfter, uint dust) {\\n dust = _amount % _ld2sdRate();\\n amountAfter = _amount - dust;\\n }\\n\\n function _encodeSendPayload(bytes32 _toAddress, uint64 _amountSD) internal view virtual returns (bytes memory) {\\n return abi.encodePacked(PT_SEND, _toAddress, _amountSD);\\n }\\n\\n function _decodeSendPayload(bytes memory _payload) internal view virtual returns (address to, uint64 amountSD) {\\n require(_payload.toUint8(0) == PT_SEND && _payload.length == 41, \\\"OFTCore: invalid payload\\\");\\n\\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\\n amountSD = _payload.toUint64(33);\\n }\\n\\n function _encodeSendAndCallPayload(\\n address _from,\\n bytes32 _toAddress,\\n uint64 _amountSD,\\n bytes memory _payload,\\n uint64 _dstGasForCall\\n ) internal view virtual returns (bytes memory) {\\n return abi.encodePacked(PT_SEND_AND_CALL, _toAddress, _amountSD, _addressToBytes32(_from), _dstGasForCall, _payload);\\n }\\n\\n function _decodeSendAndCallPayload(bytes memory _payload)\\n internal\\n view\\n virtual\\n returns (\\n bytes32 from,\\n address to,\\n uint64 amountSD,\\n bytes memory payload,\\n uint64 dstGasForCall\\n )\\n {\\n require(_payload.toUint8(0) == PT_SEND_AND_CALL, \\\"OFTCore: invalid payload\\\");\\n\\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\\n amountSD = _payload.toUint64(33);\\n from = _payload.toBytes32(41);\\n dstGasForCall = _payload.toUint64(73);\\n payload = _payload.slice(81, _payload.length - 81);\\n }\\n\\n function _addressToBytes32(address _address) internal pure virtual returns (bytes32) {\\n return bytes32(uint(uint160(_address)));\\n }\\n\\n function _debitFrom(\\n address _from,\\n uint16 _dstChainId,\\n bytes32 _toAddress,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _creditTo(\\n uint16 _srcChainId,\\n address _toAddress,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _transferFrom(\\n address _from,\\n address _to,\\n uint _amount\\n ) internal virtual returns (uint);\\n\\n function _ld2sdRate() internal view virtual returns (uint);\\n}\\n\",\"keccak256\":\"0x96cf7a10c5af4243822d25e77985a4a46d12264f839593ded5378cd6519a8df0\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/ICommonOFT.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"@openzeppelin/contracts/utils/introspection/IERC165.sol\\\";\\n\\n/**\\n * @dev Interface of the IOFT core standard\\n */\\ninterface ICommonOFT is IERC165 {\\n\\n struct LzCallParams {\\n address payable refundAddress;\\n address zroPaymentAddress;\\n bytes adapterParams;\\n }\\n\\n /**\\n * @dev estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`)\\n * _dstChainId - L0 defined chain id to send tokens too\\n * _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain\\n * _amount - amount of the tokens to transfer\\n * _useZro - indicates to use zro to pay L0 fees\\n * _adapterParam - flexible bytes array to indicate messaging adapter services in L0\\n */\\n function estimateSendFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\\n\\n function estimateSendAndCallFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\\n\\n /**\\n * @dev returns the circulating amount of tokens on current chain\\n */\\n function circulatingSupply() external view returns (uint);\\n\\n /**\\n * @dev returns the address of the ERC20 token\\n */\\n function token() external view returns (address);\\n}\\n\",\"keccak256\":\"0x1d034ba786436c1fce8057352c87373098bd1d8026b24c8fbc7be28636d0c15d\",\"license\":\"MIT\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTReceiverV2.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\n\\npragma solidity >=0.5.0;\\n\\ninterface IOFTReceiverV2 {\\n /**\\n * @dev Called by the OFT contract when tokens are received from source chain.\\n * @param _srcChainId The chain id of the source chain.\\n * @param _srcAddress The address of the OFT token contract on the source chain.\\n * @param _nonce The nonce of the transaction on the source chain.\\n * @param _from The address of the account who calls the sendAndCall() on the source chain.\\n * @param _amount The amount of tokens to transfer.\\n * @param _payload Additional data with no specified format.\\n */\\n function onOFTReceived(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes32 _from, uint _amount, bytes calldata _payload) external;\\n}\\n\",\"keccak256\":\"0xf57e437ced3bc10bb333123bb49475dab47c7615b86401c4d872c29ad4928fd5\",\"license\":\"BUSL-1.1\"},\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTV2.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n\\npragma solidity >=0.5.0;\\n\\nimport \\\"./ICommonOFT.sol\\\";\\n\\n/**\\n * @dev Interface of the IOFT core standard\\n */\\ninterface IOFTV2 is ICommonOFT {\\n\\n /**\\n * @dev send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from`\\n * `_from` the owner of token\\n * `_dstChainId` the destination chain identifier\\n * `_toAddress` can be any size depending on the `dstChainId`.\\n * `_amount` the quantity of tokens in wei\\n * `_refundAddress` the address LayerZero refunds if too much message fee is sent\\n * `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token)\\n * `_adapterParams` is a flexible bytes array to indicate messaging adapter services\\n */\\n function sendFrom(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, LzCallParams calldata _callParams) external payable;\\n\\n function sendAndCall(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, LzCallParams calldata _callParams) external payable;\\n}\\n\",\"keccak256\":\"0xb1d31f341715347d49db4e2c0de27c49bbd70b5b3d9b0adb1050b2b3a305ab87\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n _requireNotPaused();\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n _requirePaused();\\n _;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Throws if the contract is paused.\\n */\\n function _requireNotPaused() internal view virtual {\\n require(!paused(), \\\"Pausable: paused\\\");\\n }\\n\\n /**\\n * @dev Throws if the contract is not paused.\\n */\\n function _requirePaused() internal view virtual {\\n require(paused(), \\\"Pausable: not paused\\\");\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0x0849d93b16c9940beb286a7864ed02724b248b93e0d80ef6355af5ef15c64773\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xec63854014a5b4f2b3290ab9103a21bdf902a508d0f41a8573fea49e98bf571a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/ERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./IERC165.sol\\\";\\n\\n/**\\n * @dev Implementation of the {IERC165} interface.\\n *\\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\\n * for the additional interface id that will be supported. For example:\\n *\\n * ```solidity\\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\\n * }\\n * ```\\n *\\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\\n */\\nabstract contract ERC165 is IERC165 {\\n /**\\n * @dev See {IERC165-supportsInterface}.\\n */\\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\\n return interfaceId == type(IERC165).interfaceId;\\n }\\n}\\n\",\"keccak256\":\"0xd10975de010d89fd1c78dc5e8a9a7e7f496198085c151648f20cba166b32582b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\\n *\\n * Implementers can declare support of contract interfaces, which can then be\\n * queried by others ({ERC165Checker}).\\n *\\n * For an implementation, see {ERC165}.\\n */\\ninterface IERC165 {\\n /**\\n * @dev Returns true if this contract implements the interface defined by\\n * `interfaceId`. See the corresponding\\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\\n * to learn more about how these ids are created.\\n *\\n * This function call must use less than 30 000 gas.\\n */\\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x447a5f3ddc18419d41ff92b3773fb86471b1db25773e07f877f548918a185bf1\",\"license\":\"MIT\"},\"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\ninterface OracleInterface {\\n function getPrice(address asset) external view returns (uint256);\\n}\\n\\ninterface ResilientOracleInterface is OracleInterface {\\n function updatePrice(address vToken) external;\\n\\n function updateAssetPrice(address asset) external;\\n\\n function getUnderlyingPrice(address vToken) external view returns (uint256);\\n}\\n\\ninterface TwapInterface is OracleInterface {\\n function updateTwap(address asset) external returns (uint256);\\n}\\n\\ninterface BoundValidatorInterface {\\n function validatePriceWithAnchorPrice(\\n address asset,\\n uint256 reporterPrice,\\n uint256 anchorPrice\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x2432799b0d824fc701beb4c30146e912b9aeecf77b5c1635dde6c5fbe6bfc3a7\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \\\"./constants.sol\\\";\\n\\n/**\\n * @title Exponential module for storing fixed-precision decimals\\n * @author Compound\\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\\n * `Exp({mantissa: 5100000000000000000})`.\\n */\\ncontract ExponentialNoError {\\n struct Exp {\\n uint256 mantissa;\\n }\\n\\n struct Double {\\n uint256 mantissa;\\n }\\n\\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\\n uint256 internal constant DOUBLE_SCALE = 1e36;\\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\\n\\n /**\\n * @dev Truncates the given exp to a whole number value.\\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\\n */\\n function truncate(Exp memory exp) internal pure returns (uint256) {\\n // Note: We are not using careful math here as we're performing a division that cannot fail\\n return exp.mantissa / EXP_SCALE;\\n }\\n\\n /**\\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\\n Exp memory product = mul_(a, scalar);\\n return truncate(product);\\n }\\n\\n /**\\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\\n Exp memory product = mul_(a, scalar);\\n return add_(truncate(product), addend);\\n }\\n\\n /**\\n * @dev Checks if first Exp is less than second Exp.\\n */\\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\\n return left.mantissa < right.mantissa;\\n }\\n\\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\\n require(n <= type(uint224).max, errorMessage);\\n return uint224(n);\\n }\\n\\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\\n require(n <= type(uint32).max, errorMessage);\\n return uint32(n);\\n }\\n\\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\\n }\\n\\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\\n }\\n\\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\\n }\\n\\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\\n }\\n\\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\\n }\\n\\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: mul_(a.mantissa, b) });\\n }\\n\\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\\n return mul_(a, b.mantissa) / EXP_SCALE;\\n }\\n\\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\\n }\\n\\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: mul_(a.mantissa, b) });\\n }\\n\\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\\n }\\n\\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\\n }\\n\\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\\n return Exp({ mantissa: div_(a.mantissa, b) });\\n }\\n\\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\\n return div_(mul_(a, EXP_SCALE), b.mantissa);\\n }\\n\\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\\n }\\n\\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(a.mantissa, b) });\\n }\\n\\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\\n }\\n\\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\\n }\\n}\\n\",\"keccak256\":\"0x1b5378848f1472660fd33c260fa9b00bf59e7c2066c27cc592230d7c86a6a9f9\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/constants.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\\nuint256 constant EXP_SCALE = 1e18;\\n\\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\\nuint256 constant MANTISSA_ONE = EXP_SCALE;\\n\\n/// @dev The approximate number of seconds per year\\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\\n\",\"keccak256\":\"0x14de93ead464da249af31bea0e3bcfb62ec693bea3475fb4d90f055ac81dc5eb\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Thrown if the supplied value is 0 where it is not allowed\\nerror ZeroValueNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\\n/// @notice Checks if the provided value is nonzero, reverts otherwise\\n/// @param value_ Value to check\\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\\nfunction ensureNonzeroValue(uint256 value_) pure {\\n if (value_ == 0) {\\n revert ZeroValueNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0xdb88e14d50dd21889ca3329d755673d022c47e8da005b6a545c7f69c2c4b7b86\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/BaseXVSProxyOFT.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { ResilientOracleInterface } from \\\"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\\\";\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { BaseOFTV2 } from \\\"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\\\";\\nimport { ensureNonzeroAddress } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { ExponentialNoError } from \\\"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\\\";\\n\\n/**\\n * @title BaseXVSProxyOFT\\n * @author Venus\\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\\n * It manages transaction limits of a single and daily transactions.\\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\\n */\\n\\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\\n using SafeERC20 for IERC20;\\n IERC20 internal immutable innerToken;\\n uint256 internal immutable ld2sdRate;\\n bool public sendAndCallEnabled;\\n\\n /**\\n * @notice The address of ResilientOracle contract wrapped in its interface.\\n */\\n ResilientOracleInterface public oracle;\\n /**\\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\\n /**\\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\\n /**\\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\\n /**\\n * @notice Timestamp when the last 24-hour window started from local chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\\n /**\\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\\n /**\\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\\n /**\\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\\n /**\\n * @notice Timestamp when the last 24-hour window started from remote chain.\\n */\\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\\n /**\\n * @notice Address on which cap check and bound limit is not applicable.\\n */\\n mapping(address => bool) public whitelist;\\n\\n /**\\n * @notice Emitted when address is added to whitelist.\\n */\\n event SetWhitelist(address indexed addr, bool isWhitelist);\\n /**\\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\\n */\\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\\n */\\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\\n */\\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\\n */\\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\\n /**\\n * @notice Event emitted when oracle is modified.\\n */\\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\\n /**\\n * @notice Event emitted when trusted remote sets to empty.\\n */\\n event TrustedRemoteRemoved(uint16 chainId);\\n /**\\n * @notice Event emitted when inner token set successfully.\\n */\\n event InnerTokenAdded(address indexed innerToken);\\n /**\\n *@notice Emitted on sweep token success\\n */\\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\\n /**\\n * @notice Event emitted when SendAndCallEnabled updated successfully.\\n */\\n event UpdateSendAndCallEnabled(bool indexed enabled);\\n /**\\n *@notice Error thrown when this contract balance is less than sweep amount\\n */\\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\\n\\n /**\\n * @param tokenAddress_ Address of the inner token.\\n * @param sharedDecimals_ Number of shared decimals.\\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\\n * @param oracle_ Address of the price oracle.\\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\\n * @custom:event Emits InnerTokenAdded with token address.\\n * @custom:event Emits OracleChanged with zero address and oracle address.\\n */\\n constructor(\\n address tokenAddress_,\\n uint8 sharedDecimals_,\\n address lzEndpoint_,\\n address oracle_\\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\\n ensureNonzeroAddress(tokenAddress_);\\n ensureNonzeroAddress(lzEndpoint_);\\n ensureNonzeroAddress(oracle_);\\n\\n innerToken = IERC20(tokenAddress_);\\n\\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\\\"decimals()\\\"));\\n require(success, \\\"ProxyOFT: failed to get token decimals\\\");\\n uint8 decimals = abi.decode(data, (uint8));\\n\\n require(sharedDecimals_ <= decimals, \\\"ProxyOFT: sharedDecimals must be <= decimals\\\");\\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\\n\\n emit InnerTokenAdded(tokenAddress_);\\n emit OracleChanged(address(0), oracle_);\\n\\n oracle = ResilientOracleInterface(oracle_);\\n }\\n\\n /**\\n * @notice Set the address of the ResilientOracle contract.\\n * @dev Reverts if the new address is zero.\\n * @param oracleAddress_ The new address of the ResilientOracle contract.\\n * @custom:access Only owner.\\n * @custom:event Emits OracleChanged with old and new oracle address.\\n */\\n function setOracle(address oracleAddress_) external onlyOwner {\\n ensureNonzeroAddress(oracleAddress_);\\n emit OracleChanged(address(oracle), oracleAddress_);\\n oracle = ResilientOracleInterface(oracleAddress_);\\n }\\n\\n /**\\n * @notice Sets the limit of single transaction amount.\\n * @param chainId_ Destination chain id.\\n * @param limit_ Amount in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\\n */\\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \\\"Single transaction limit > Daily limit\\\");\\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the limit of daily (24 Hour) transactions amount.\\n * @param chainId_ Destination chain id.\\n * @param limit_ Amount in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\\n */\\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \\\"Daily limit < single transaction limit\\\");\\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\\n chainIdToMaxDailyLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the maximum limit for a single receive transaction.\\n * @param chainId_ The destination chain ID.\\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\\n */\\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \\\"single receive transaction limit > Daily limit\\\");\\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the maximum daily limit for receiving transactions.\\n * @param chainId_ The destination chain ID.\\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\\n * @custom:access Only owner.\\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\\n */\\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\\n require(\\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\\n \\\"Daily limit < single receive transaction limit\\\"\\n );\\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\\n }\\n\\n /**\\n * @notice Sets the whitelist address to skip checks on transaction limit.\\n * @param user_ Address to be add in whitelist.\\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\\n * @custom:access Only owner.\\n * @custom:event Emits setWhitelist.\\n */\\n function setWhitelist(address user_, bool val_) external onlyOwner {\\n emit SetWhitelist(user_, val_);\\n whitelist[user_] = val_;\\n }\\n\\n /**\\n * @notice Triggers stopped state of the bridge.\\n * @custom:access Only owner.\\n */\\n function pause() external onlyOwner {\\n _pause();\\n }\\n\\n /**\\n * @notice Triggers resume state of the bridge.\\n * @custom:access Only owner.\\n */\\n function unpause() external onlyOwner {\\n _unpause();\\n }\\n\\n /**\\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\\n * @param token_ The address of the ERC-20 token to sweep\\n * @param to_ The address of the recipient\\n * @param amount_ The amount of tokens needs to transfer\\n * @custom:event Emits SweepToken event\\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\\n * @custom:access Only Owner\\n */\\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\\n uint256 balance = token_.balanceOf(address(this));\\n if (amount_ > balance) {\\n revert InsufficientBalance(amount_, balance);\\n }\\n\\n emit SweepToken(address(token_), to_, amount_);\\n\\n token_.safeTransfer(to_, amount_);\\n }\\n\\n /**\\n * @notice Remove trusted remote from storage.\\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\\n * @custom:access Only owner.\\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\\n */\\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\\n delete trustedRemoteLookup[remoteChainId_];\\n emit TrustedRemoteRemoved(remoteChainId_);\\n }\\n\\n /**\\n * @notice It enables or disables sendAndCall functionality for the bridge.\\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\\n */\\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\\n sendAndCallEnabled = enabled_;\\n emit UpdateSendAndCallEnabled(enabled_);\\n }\\n\\n /**\\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\\n * @param from_ The sender's address initiating the transfer.\\n * @param dstChainId_ Indicates destination chain.\\n * @param amount_ The quantity of tokens to be transferred.\\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\\n * @return maxDailyLimit The maximum daily limit for transactions.\\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\\n */\\n function isEligibleToSend(\\n address from_,\\n uint16 dstChainId_,\\n uint256 amount_\\n )\\n external\\n view\\n returns (\\n bool eligibleToSend,\\n uint256 maxSingleTransactionLimit,\\n uint256 maxDailyLimit,\\n uint256 amountInUsd,\\n uint256 transferredInWindow,\\n uint256 last24HourWindowStart,\\n bool isWhiteListedUser\\n )\\n {\\n // Check if the sender's address is whitelisted\\n isWhiteListedUser = whitelist[from_];\\n\\n // Calculate the amount in USD using the oracle price\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\\n\\n // Load values for the 24-hour window checks\\n uint256 currentBlockTimestamp = block.timestamp;\\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\\n transferredInWindow = amountInUsd;\\n last24HourWindowStart = currentBlockTimestamp;\\n } else {\\n transferredInWindow += amountInUsd;\\n }\\n eligibleToSend = (isWhiteListedUser ||\\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\\n }\\n\\n /**\\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\\n * @param from_ Address from which tokens will be debited.\\n * @param dstChainId_ Destination chain id on which tokens will be send.\\n * @param toAddress_ Address on which tokens will be credited on destination chain.\\n * @param amount_ Amount of tokens that will be transferred.\\n * @param payload_ Additional data payload for the call on the destination chain.\\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\\n * and adapter params.\\n */\\n function sendAndCall(\\n address from_,\\n uint16 dstChainId_,\\n bytes32 toAddress_,\\n uint256 amount_,\\n bytes calldata payload_,\\n uint64 dstGasForCall_,\\n LzCallParams calldata callparams_\\n ) public payable override {\\n require(sendAndCallEnabled, \\\"sendAndCall is disabled\\\");\\n\\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\\n }\\n\\n function retryMessage(\\n uint16 _srcChainId,\\n bytes calldata _srcAddress,\\n uint64 _nonce,\\n bytes calldata _payload\\n ) public payable override {\\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\\n require(\\n _srcAddress.length == trustedRemote.length &&\\n trustedRemote.length > 0 &&\\n keccak256(_srcAddress) == keccak256(trustedRemote),\\n \\\"LzApp: invalid source sending contract\\\"\\n );\\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\\n }\\n\\n /**\\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\\n */\\n function renounceOwnership() public override {}\\n\\n /**\\n * @notice Return's the address of the inner token of this bridge.\\n * @return Address of the inner token of this bridge.\\n */\\n function token() public view override returns (address) {\\n return address(innerToken);\\n }\\n\\n /**\\n * @notice Checks if the sender is eligible to send tokens\\n * @param from_ Sender's address sending tokens\\n * @param dstChainId_ Chain id on which tokens should be sent\\n * @param amount_ Amount of tokens to be sent\\n */\\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\\n // Check if the sender's address is whitelisted\\n bool isWhiteListedUser = whitelist[from_];\\n // Check if the user is whitelisted and return if true\\n if (isWhiteListedUser) {\\n return;\\n }\\n\\n // Calculate the amount in USD using the oracle price\\n uint256 amountInUsd;\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\\n\\n // Load values for the 24-hour window checks\\n uint256 currentBlockTimestamp = block.timestamp;\\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\\n\\n // Revert if the amount exceeds the single transaction limit\\n require(amountInUsd <= maxSingleTransactionLimit, \\\"Single Transaction Limit Exceed\\\");\\n\\n // Check if the time window has changed (more than 24 hours have passed)\\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\\n transferredInWindow = amountInUsd;\\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\\n } else {\\n transferredInWindow += amountInUsd;\\n }\\n\\n // Revert if the amount exceeds the daily limit\\n require(transferredInWindow <= maxDailyLimit, \\\"Daily Transaction Limit Exceed\\\");\\n\\n // Update the amount for the 24-hour window\\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\\n }\\n\\n /**\\n * @notice Checks if receiver is able to receive tokens\\n * @param toAddress_ Receiver address\\n * @param srcChainId_ Source chain id from which token is send\\n * @param receivedAmount_ Amount of tokens received\\n */\\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\\n // Check if the recipient's address is whitelisted\\n bool isWhiteListedUser = whitelist[toAddress_];\\n // Check if the user is whitelisted and return if true\\n if (isWhiteListedUser) {\\n return;\\n }\\n\\n // Calculate the received amount in USD using the oracle price\\n uint256 receivedAmountInUsd;\\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\\n\\n uint256 currentBlockTimestamp = block.timestamp;\\n\\n // Load values for the 24-hour window checks for receiving\\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\\n\\n // Check if the received amount exceeds the single transaction limit\\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \\\"Single Transaction Limit Exceed\\\");\\n\\n // Check if the time window has changed (more than 24 hours have passed)\\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\\n receivedInWindow = receivedAmountInUsd;\\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\\n } else {\\n receivedInWindow += receivedAmountInUsd;\\n }\\n\\n // Revert if the received amount exceeds the daily limit\\n require(receivedInWindow <= maxDailyReceiveLimit, \\\"Daily Transaction Limit Exceed\\\");\\n\\n // Update the received amount for the 24-hour window\\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\\n }\\n\\n /**\\n * @notice Transfer tokens from sender to receiver account.\\n * @param from_ Address from which token has to be transferred(Sender).\\n * @param to_ Address on which token will be tranferred(Receiver).\\n * @param amount_ Amount of token to be transferred.\\n * @return Actual balance difference.\\n */\\n function _transferFrom(\\n address from_,\\n address to_,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n uint256 before = innerToken.balanceOf(to_);\\n if (from_ == address(this)) {\\n innerToken.safeTransfer(to_, amount_);\\n } else {\\n innerToken.safeTransferFrom(from_, to_, amount_);\\n }\\n return innerToken.balanceOf(to_) - before;\\n }\\n\\n /**\\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\\n * @return Conversion rate factor.\\n */\\n function _ld2sdRate() internal view override returns (uint256) {\\n return ld2sdRate;\\n }\\n}\\n\",\"keccak256\":\"0x7e60e0dad246890a0f4b796aeb3fa730cd7cfde1f5616f4b10611b2f469d1e10\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/XVSProxyOFTDest.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { IXVS } from \\\"./interfaces/IXVS.sol\\\";\\nimport { BaseXVSProxyOFT } from \\\"./BaseXVSProxyOFT.sol\\\";\\n\\n/**\\n * @title XVSProxyOFTDest\\n * @author Venus\\n * @notice XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT,\\n * and focuses on managing token transfers to the destination chain.\\n * It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\\n */\\n\\ncontract XVSProxyOFTDest is BaseXVSProxyOFT {\\n /**\\n * @notice Emits when stored message dropped without successful retrying.\\n */\\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\\n\\n constructor(\\n address tokenAddress_,\\n uint8 sharedDecimals_,\\n address lzEndpoint_,\\n address oracle_\\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\\n\\n /**\\n * @notice Clear failed messages from the storage.\\n * @param srcChainId_ Chain id of source\\n * @param srcAddress_ Address of source followed by current bridge address\\n * @param nonce_ Nonce_ of the transaction\\n * @custom:access Only owner\\n * @custom:event Emits DropFailedMessage on clearance of failed message.\\n */\\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\\n }\\n\\n /**\\n * @notice Returns the total circulating supply of the token on the destination chain i.e (total supply).\\n * @return total circulating supply of the token on the destination chain.\\n */\\n function circulatingSupply() public view override returns (uint256) {\\n return innerToken.totalSupply();\\n }\\n\\n /**\\n * @notice Debit tokens from the given address\\n * @param from_ Address from which tokens to be debited\\n * @param dstChainId_ Destination chain id\\n * @param amount_ Amount of tokens to be debited\\n * @return Actual amount debited\\n */\\n function _debitFrom(\\n address from_,\\n uint16 dstChainId_,\\n bytes32,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n require(from_ == _msgSender(), \\\"ProxyOFT: owner is not send caller\\\");\\n _isEligibleToSend(from_, dstChainId_, amount_);\\n IXVS(address(innerToken)).burn(from_, amount_);\\n return amount_;\\n }\\n\\n /**\\n * @notice Credit tokens in the given account\\n * @param srcChainId_ Source chain id\\n * @param toAddress_ Address on which token will be credited\\n * @param amount_ Amount of tokens to be credited\\n * @return Actual amount credited\\n */\\n function _creditTo(\\n uint16 srcChainId_,\\n address toAddress_,\\n uint256 amount_\\n ) internal override whenNotPaused returns (uint256) {\\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\\n IXVS(address(innerToken)).mint(toAddress_, amount_);\\n return amount_;\\n }\\n}\\n\",\"keccak256\":\"0x127d20692944707c3d5f08bb1872f83015731705a7905cf93161cd6c7d0c10df\",\"license\":\"BSD-3-Clause\"},\"contracts/Bridge/interfaces/IXVS.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\n/**\\n * @title IXVS\\n * @author Venus\\n * @notice Interface implemented by `XVS` token.\\n */\\ninterface IXVS {\\n function mint(address to, uint256 amount) external;\\n\\n function burn(address from, uint256 amount) external;\\n}\\n\",\"keccak256\":\"0xd3e26dcde753c28be8f826806c18fbf92918baa0f4f972a96916a15831ce5d03\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x61010060405234801561001157600080fd5b50604051615b2b380380615b2b8339810160408190526100309161035b565b6000805460ff191690558383838382828181808061004d336102ab565b6001600160a01b0316608052505060ff1660a0525061006d905084610304565b61007682610304565b61007f81610304565b6001600160a01b03841660c081905260408051600481526024810182526020810180516001600160e01b031663313ce56760e01b1790529051600092839290916100c991906103af565b600060405180830381855afa9150503d8060008114610104576040519150601f19603f3d011682016040523d82523d6000602084013e610109565b606091505b50915091508161016f5760405162461bcd60e51b815260206004820152602660248201527f50726f78794f46543a206661696c656420746f2067657420746f6b656e20646560448201526563696d616c7360d01b60648201526084015b60405180910390fd5b60008180602001905181019061018591906103de565b90508060ff168660ff1611156101f25760405162461bcd60e51b815260206004820152602c60248201527f50726f78794f46543a20736861726564446563696d616c73206d75737420626560448201526b203c3d20646563696d616c7360a01b6064820152608401610166565b6101fc8682610416565b61020790600a610519565b60e0526040516001600160a01b038816907f0b673f021ff9a27bbe58f282908695869e130b3103029190387b83650806c2c390600090a26040516001600160a01b038516906000907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd908290a35050600780546001600160a01b0390931661010002610100600160a81b031990931692909217909155506105289650505050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6001600160a01b03811661032b576040516342bcdf7f60e11b815260040160405180910390fd5b50565b80516001600160a01b038116811461034557600080fd5b919050565b805160ff8116811461034557600080fd5b6000806000806080858703121561037157600080fd5b61037a8561032e565b93506103886020860161034a565b92506103966040860161032e565b91506103a46060860161032e565b905092959194509250565b6000825160005b818110156103d057602081860181015185830152016103b6565b506000920191825250919050565b6000602082840312156103f057600080fd5b6103f98261034a565b9392505050565b634e487b7160e01b600052601160045260246000fd5b60ff828116828216039081111561042f5761042f610400565b92915050565b600181815b8085111561047057816000190482111561045657610456610400565b8085161561046357918102915b93841c939080029061043a565b509250929050565b6000826104875750600161042f565b816104945750600061042f565b81600181146104aa57600281146104b4576104d0565b600191505061042f565b60ff8411156104c5576104c5610400565b50506001821b61042f565b5060208310610133831016604e8410600b84101617156104f3575081810a61042f565b6104fd8383610435565b806000190482111561051157610511610400565b029392505050565b60006103f960ff841683610478565b60805160a05160c05160e0516155376105f4600039600081816130ca0152818161363d0152613b78015260008181610ca10152818161106801528181611ba701528181612d6b01528181612df701528181612e3001528181612e790152818161371301528181613be101528181613daa01526141da015260006108be015260008181610abe01528181610cf501528181610f3c01528181610fe40152818161142601528181611ecf015281816123c20152818161259d01528181612a9b01526138a101526155376000f3fe6080604052600436106103b75760003560e01c80637dc0d1d0116101f2578063baf3292d1161010d578063df2a5b3b116100a0578063f2fde38b1161006f578063f2fde38b14610c52578063f5ecbdbc14610c72578063fc0c546a14610c92578063fdff235b14610cc557600080fd5b8063df2a5b3b14610bdd578063e6a20ae614610bfd578063eaffd49a14610c12578063eb8d72b714610c3257600080fd5b8063cc01e9b6116100dc578063cc01e9b614610b50578063cc7015ae14610b70578063d1deba1f14610b9d578063d708a46814610bb057600080fd5b8063baf3292d14610ae0578063c1e9132e14610b00578063c446183414610b1a578063cbed8b9c14610b3057600080fd5b806393a61d6c116101855780639f38369a116101545780639f38369a14610a4c578063a4c51df514610a6c578063a6c3d16514610a8c578063b353aaa714610aac57600080fd5b806393a61d6c1461097d578063950c8a74146109aa5780639b19251a146109ca5780639bdb9812146109fa57600080fd5b80638cfd8f5c116101c15780638cfd8f5c146108e05780638da5cb5b14610918578063904365671461093b5780639358928b1461096857600080fd5b80637dc0d1d01461083a5780638456cb591461087757806384e69c691461088c578063857749b0146108ac57600080fd5b80634c42899a116102e257806364aff9ec11610275578063715018a611610244578063715018a6146107ce5780637533d788146107da57806376203b48146108075780637adbf9731461081a57600080fd5b806364aff9ec1461075b57806366ad5c8a1461077b578063695ef6bf1461079b57806369c1e7b8146107ae57600080fd5b806353489d6c116102b157806353489d6c146106b457806353d6fd59146106d45780635b8c41e6146106f45780635c975abb1461074357600080fd5b80634c42899a146106135780634cec62561461063a5780634ed2c662146106675780634f4ba0f41461068757600080fd5b80632dbbec081161035a5780633f1f4fa4116103295780633f1f4fa41461059c5780633f4ba83a146105c957806342d65a8d146105de57806344770515146105fe57600080fd5b80632dbbec08146104ec578063365260b41461050c5780633c4ec39b146105415780633d8b38f61461057c57600080fd5b80630df37483116103965780630df374831461043357806310ddb13714610453578063182b4b89146104735780632488eec8146104cc57600080fd5b80621d3567146103bc57806301ffc9a7146103de57806307e0db1714610413575b600080fd5b3480156103c857600080fd5b506103dc6103d736600461456a565b610cf2565b005b3480156103ea57600080fd5b506103fe6103f93660046145fd565b610ee4565b60405190151581526020015b60405180910390f35b34801561041f57600080fd5b506103dc61042e366004614627565b610f1b565b34801561043f57600080fd5b506103dc61044e366004614642565b610fa4565b34801561045f57600080fd5b506103dc61046e366004614627565b610fc3565b34801561047f57600080fd5b5061049361048e366004614681565b61101b565b6040805197151588526020880196909652948601939093526060850191909152608084015260a0830152151560c082015260e00161040a565b3480156104d857600080fd5b506103dc6104e7366004614642565b611191565b3480156104f857600080fd5b506103dc610507366004614627565b611275565b34801561051857600080fd5b5061052c6105273660046146cd565b6112d4565b6040805192835260208301919091520161040a565b34801561054d57600080fd5b5061056e61055c366004614627565b600d6020526000908152604090205481565b60405190815260200161040a565b34801561058857600080fd5b506103fe610597366004614734565b611329565b3480156105a857600080fd5b5061056e6105b7366004614627565b60036020526000908152604090205481565b3480156105d557600080fd5b506103dc6113f5565b3480156105ea57600080fd5b506103dc6105f9366004614734565b611407565b34801561060a57600080fd5b5061056e600081565b34801561061f57600080fd5b50610628600081565b60405160ff909116815260200161040a565b34801561064657600080fd5b5061056e610655366004614627565b600a6020526000908152604090205481565b34801561067357600080fd5b506103dc610682366004614786565b61148d565b34801561069357600080fd5b5061056e6106a2366004614627565b60096020526000908152604090205481565b3480156106c057600080fd5b506103dc6106cf366004614642565b6114d2565b3480156106e057600080fd5b506103dc6106ef3660046147a3565b6115b6565b34801561070057600080fd5b5061056e61070f366004614849565b6005602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205481565b34801561074f57600080fd5b5060005460ff166103fe565b34801561076757600080fd5b506103dc6107763660046148e9565b61162e565b34801561078757600080fd5b506103dc61079636600461456a565b611735565b6103dc6107a9366004614942565b611811565b3480156107ba57600080fd5b506103dc6107c9366004614642565b61187c565b3480156103dc57600080fd5b3480156107e657600080fd5b506107fa6107f5366004614627565b611968565b60405161040a9190614a05565b6103dc610815366004614a18565b611a02565b34801561082657600080fd5b506103dc610835366004614aca565b611a6e565b34801561084657600080fd5b5060075461085f9061010090046001600160a01b031681565b6040516001600160a01b03909116815260200161040a565b34801561088357600080fd5b506103dc611ae6565b34801561089857600080fd5b506103dc6108a7366004614849565b611af6565b3480156108b857600080fd5b506106287f000000000000000000000000000000000000000000000000000000000000000081565b3480156108ec57600080fd5b5061056e6108fb366004614ae7565b600260209081526000928352604080842090915290825290205481565b34801561092457600080fd5b5060005461010090046001600160a01b031661085f565b34801561094757600080fd5b5061056e610956366004614627565b600c6020526000908152604090205481565b34801561097457600080fd5b5061056e611ba3565b34801561098957600080fd5b5061056e610998366004614627565b600b6020526000908152604090205481565b3480156109b657600080fd5b5060045461085f906001600160a01b031681565b3480156109d657600080fd5b506103fe6109e5366004614aca565b60106020526000908152604090205460ff1681565b348015610a0657600080fd5b506103fe610a15366004614849565b6006602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205460ff1681565b348015610a5857600080fd5b506107fa610a67366004614627565b611c2c565b348015610a7857600080fd5b5061052c610a87366004614b1a565b611d42565b348015610a9857600080fd5b506103dc610aa7366004614734565b611dd1565b348015610ab857600080fd5b5061085f7f000000000000000000000000000000000000000000000000000000000000000081565b348015610aec57600080fd5b506103dc610afb366004614aca565b611e5a565b348015610b0c57600080fd5b506007546103fe9060ff1681565b348015610b2657600080fd5b5061056e61271081565b348015610b3c57600080fd5b506103dc610b4b366004614bd7565b611eb0565b348015610b5c57600080fd5b506103dc610b6b366004614642565b611f45565b348015610b7c57600080fd5b5061056e610b8b366004614627565b60086020526000908152604090205481565b6103dc610bab36600461456a565b612031565b348015610bbc57600080fd5b5061056e610bcb366004614627565b600e6020526000908152604090205481565b348015610be957600080fd5b506103dc610bf8366004614c45565b612135565b348015610c0957600080fd5b50610628600181565b348015610c1e57600080fd5b506103dc610c2d366004614c63565b61219f565b348015610c3e57600080fd5b506103dc610c4d366004614734565b6122be565b348015610c5e57600080fd5b506103dc610c6d366004614aca565b612318565b348015610c7e57600080fd5b506107fa610c8d366004614d2b565b612391565b348015610c9e57600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061085f565b348015610cd157600080fd5b5061056e610ce0366004614627565b600f6020526000908152604090205481565b337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031614610d6f5760405162461bcd60e51b815260206004820152601e60248201527f4c7a4170703a20696e76616c696420656e64706f696e742063616c6c6572000060448201526064015b60405180910390fd5b61ffff861660009081526001602052604081208054610d8d90614d78565b80601f0160208091040260200160405190810160405280929190818152602001828054610db990614d78565b8015610e065780601f10610ddb57610100808354040283529160200191610e06565b820191906000526020600020905b815481529060010190602001808311610de957829003601f168201915b50505050509050805186869050148015610e21575060008151115b8015610e49575080516020820120604051610e3f9088908890614dac565b6040518091039020145b610e655760405162461bcd60e51b8152600401610d6690614dbc565b610edb8787878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8a018190048102820181019092528881528a93509150889088908190840183828082843760009201919091525061244492505050565b50505050505050565b60006001600160e01b03198216631f7ecdf760e01b1480610f1557506301ffc9a760e01b6001600160e01b03198316145b92915050565b610f236124bd565b6040516307e0db1760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906307e0db17906024015b600060405180830381600087803b158015610f8957600080fd5b505af1158015610f9d573d6000803e3d6000fd5b5050505050565b610fac6124bd565b61ffff909116600090815260036020526040902055565b610fcb6124bd565b6040516310ddb13760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906310ddb13790602401610f6f565b6001600160a01b03838116600090815260106020908152604080832054815192830190915260075492938493849384938493849360ff909216928492909182916101009004166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156110cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110ef9190614e02565b905290506110fd818a61251d565b61ffff8b166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054919a509098509196509094509250426201518061114b8583614e31565b111561115c57859450809350611169565b6111668686614e44565b94505b828061118057508786111580156111805750868511155b985050509397509397509397909450565b6111996124bd565b61ffff821660009081526008602052604090205481101561120b5760405162461bcd60e51b815260206004820152602660248201527f4461696c79206c696d6974203c2073696e676c65207472616e73616374696f6e604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600960209081526040918290205482519384529083015281018290527f4dd31065e259d5284e44d1f9265710da72eafcf78dc925e3881189fc3b71f6939060600160405180910390a161ffff909116600090815260096020526040902055565b61127d6124bd565b61ffff81166000908152600160205260408120611299916144a6565b60405161ffff821681527f6d5075c81d4d9e75bec6052f4e44f58f8a8cf1327544addbbf015fb06f83bd37906020015b60405180910390a150565b60008061131a8888888888888080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061253592505050565b91509150965096945050505050565b61ffff83166000908152600160205260408120805482919061134a90614d78565b80601f016020809104026020016040519081016040528092919081815260200182805461137690614d78565b80156113c35780601f10611398576101008083540402835291602001916113c3565b820191906000526020600020905b8154815290600101906020018083116113a657829003601f168201915b5050505050905083836040516113da929190614dac565b60405180910390208180519060200120149150509392505050565b6113fd6124bd565b611405612629565b565b61140f6124bd565b6040516342d65a8d60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906342d65a8d9061145f90869086908690600401614e80565b600060405180830381600087803b15801561147957600080fd5b505af1158015610edb573d6000803e3d6000fd5b6114956124bd565b6007805460ff19168215159081179091556040517fe628f01c6f4e6340598d3a2913390db68e8859379eebff349e170f2b16baed0090600090a250565b6114da6124bd565b61ffff821660009081526009602052604090205481111561154c5760405162461bcd60e51b815260206004820152602660248201527f53696e676c65207472616e73616374696f6e206c696d6974203e204461696c79604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600860209081526040918290205482519384529083015281018290527f7babeac42ccbb33537ee421fedc4db7b5f251b5d2a3fa5c0ff4b35b2d783be879060600160405180910390a161ffff909116600090815260086020526040902055565b6115be6124bd565b816001600160a01b03167ff6019ec0a78d156d249a1ec7579e2321f6ac7521d6e1d2eacf90ba4a184dcceb826040516115fb911515815260200190565b60405180910390a26001600160a01b03919091166000908152601060205260409020805460ff1916911515919091179055565b6116366124bd565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a0823190602401602060405180830381865afa15801561167d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a19190614e02565b9050808211156116ce5760405163cf47918160e01b81526004810183905260248101829052604401610d66565b826001600160a01b0316846001600160a01b03167f6d25be279134f4ecaa4770aff0c3d916d9e7c5ef37b65ed95dbdba411f5d54d58460405161171391815260200190565b60405180910390a361172f6001600160a01b038516848461267b565b50505050565b3330146117935760405162461bcd60e51b815260206004820152602660248201527f4e6f6e626c6f636b696e674c7a4170703a2063616c6c6572206d7573742062656044820152650204c7a4170760d41b6064820152608401610d66565b6118098686868080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8901819004810282018101909252878152899350915087908790819084018382808284376000920191909152506126e392505050565b505050505050565b611809858585856118256020870187614aca565b6118356040880160208901614aca565b6118426040890189614e9e565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061276a92505050565b6118846124bd565b61ffff82166000908152600c60205260409020548110156118fe5760405162461bcd60e51b815260206004820152602e60248201527f4461696c79206c696d6974203c2073696e676c6520726563656976652074726160448201526d1b9cd858dd1a5bdb881b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600d60209081526040918290205482519384529083015281018290527f95dc51094cd27cf4ee3fd0dbb50cf96f8df1629c822f5434c4a34d7eb03c97249060600160405180910390a161ffff9091166000908152600d6020526040902055565b6001602052600090815260409020805461198190614d78565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90614d78565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b505050505081565b60075460ff16611a545760405162461bcd60e51b815260206004820152601760248201527f73656e64416e6443616c6c2069732064697361626c65640000000000000000006044820152606401610d66565b611a648888888888888888612852565b5050505050505050565b611a766124bd565b611a7f816128f6565b6007546040516001600160a01b0380841692610100900416907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd90600090a3600780546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b611aee6124bd565b61140561291d565b611afe6124bd565b61ffff83166000908152600560205260408082209051611b1f908590614ee4565b9081526040805191829003602090810183206001600160401b038616600090815291522091909155611b52908390614ee4565b6040805191829003822061ffff861683526001600160401b0384166020840152917f48a980eea4ea1c540209e2f9f32a4c2edf51fab37b1d21f453868301ecb6e2ee910160405180910390a2505050565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c03573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c279190614e02565b905090565b61ffff8116600090815260016020526040812080546060929190611c4f90614d78565b80601f0160208091040260200160405190810160405280929190818152602001828054611c7b90614d78565b8015611cc85780601f10611c9d57610100808354040283529160200191611cc8565b820191906000526020600020905b815481529060010190602001808311611cab57829003601f168201915b505050505090508051600003611d205760405162461bcd60e51b815260206004820152601d60248201527f4c7a4170703a206e6f20747275737465642070617468207265636f72640000006044820152606401610d66565b611d3b600060148351611d339190614e31565b83919061295a565b9392505050565b600080611dbf8b8b8b8b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b81528e93508d9250908c908c9081908401838280828437600092019190915250612a6792505050565b91509150995099975050505050505050565b611dd96124bd565b818130604051602001611dee93929190614f00565b60408051601f1981840301815291815261ffff8516600090815260016020522090611e199082614f6e565b507f8c0400cfe2d1199b1a725c78960bcc2a344d869b80590d0f2bd005db15a572ce838383604051611e4d93929190614e80565b60405180910390a1505050565b611e626124bd565b600480546001600160a01b0319166001600160a01b0383169081179091556040519081527f5db758e995a17ec1ad84bdef7e8c3293a0bd6179bcce400dff5d4c3d87db726b906020016112c9565b611eb86124bd565b6040516332fb62e760e21b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cbed8b9c90611f0c908890889088908890889060040161502d565b600060405180830381600087803b158015611f2657600080fd5b505af1158015611f3a573d6000803e3d6000fd5b505050505050505050565b611f4d6124bd565b61ffff82166000908152600d6020526040902054811115611fc75760405162461bcd60e51b815260206004820152602e60248201527f73696e676c652072656365697665207472616e73616374696f6e206c696d697460448201526d080f8811185a5b1e481b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600c60209081526040918290205482519384529083015281018290527f2c42997a938a029910a78e7c28d762b349c28e70f3a89c1fbccbb1a46020b1599060600160405180910390a161ffff9091166000908152600c6020526040902055565b61ffff86166000908152600160205260408120805461204f90614d78565b80601f016020809104026020016040519081016040528092919081815260200182805461207b90614d78565b80156120c85780601f1061209d576101008083540402835291602001916120c8565b820191906000526020600020905b8154815290600101906020018083116120ab57829003601f168201915b505050505090508051868690501480156120e3575060008151115b801561210b5750805160208201206040516121019088908890614dac565b6040518091039020145b6121275760405162461bcd60e51b8152600401610d6690614dbc565b610edb878787878787612b29565b61213d6124bd565b61ffff83811660008181526002602090815260408083209487168084529482529182902085905581519283528201929092529081018290527f9d5c7c0b934da8fefa9c7760c98383778a12dfbfc0c3b3106518f43fb9508ac090606001611e4d565b3330146121ee5760405162461bcd60e51b815260206004820152601f60248201527f4f4654436f72653a2063616c6c6572206d757374206265204f4654436f7265006044820152606401610d66565b6121f9308686612d3f565b9350846001600160a01b03168a61ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8660405161223b91815260200190565b60405180910390a3604051633fe79aed60e11b81526001600160a01b03861690637fcf35da90839061227f908e908e908e908e908e908d908d908d9060040161505b565b600060405180830381600088803b15801561229957600080fd5b5087f11580156122ad573d6000803e3d6000fd5b505050505050505050505050505050565b6122c66124bd565b61ffff831660009081526001602052604090206122e48284836150b6565b507ffa41487ad5d6728f0b19276fa1eddc16558578f5109fc39d2dc33c3230470dab838383604051611e4d93929190614e80565b6123206124bd565b6001600160a01b0381166123855760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d66565b61238e81612ef9565b50565b604051633d7b2f6f60e21b815261ffff808616600483015284166024820152306044820152606481018290526060907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03169063f5ecbdbc90608401600060405180830381865afa158015612411573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526124399190810190615175565b90505b949350505050565b6000806124a75a60966366ad5c8a60e01b8989898960405160240161246c94939291906151e2565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915230929190612f52565b9150915081611809576118098686868685612fdc565b6000546001600160a01b036101009091041633146114055760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d66565b60008061252a8484613079565b905061243c816130aa565b600080600061258387612547886130c2565b6040805160006020820152602181019390935260c09190911b6001600160c01b0319166041830152805160298184030181526049909201905290565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb10906125da908b90309086908b908b90600401615220565b6040805180830381865afa1580156125f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061261a9190615274565b92509250509550959350505050565b612631613148565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6040516001600160a01b0383166024820152604481018290526126de90849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152613191565b505050565b60006126ef8282613266565b905060ff811661270a57612705858585856132c2565b610f9d565b60001960ff8216016127225761270585858585613352565b60405162461bcd60e51b815260206004820152601c60248201527f4f4654436f72653a20756e6b6e6f776e207061636b65742074797065000000006044820152606401610d66565b600061277887828481613560565b61278185613635565b50905061279088888884613675565b9050600081116127de5760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006127ed87612547846130c2565b90506127fd888287878734613778565b86896001600160a01b03168961ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a8560405161283e91815260200190565b60405180910390a450979650505050505050565b611f3a8888888888888080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a925061289f9150506020890189614aca565b6128af60408a0160208b01614aca565b6128bc60408b018b614e9e565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061391d92505050565b6001600160a01b03811661238e576040516342bcdf7f60e11b815260040160405180910390fd5b612925613a12565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25861265e3390565b60608161296881601f614e44565b10156129a75760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b6044820152606401610d66565b6129b18284614e44565b845110156129f55760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b6044820152606401610d66565b606082158015612a145760405191506000825260208201604052612a5e565b6040519150601f8416801560200281840101858101878315602002848b0101015b81831015612a4d578051835260209283019201612a35565b5050858452601f01601f1916604052505b50949350505050565b6000806000612a81338a612a7a8b6130c2565b8a8a613a58565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb1090612ad8908d90309086908b908b90600401615220565b6040805180830381865afa158015612af4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b189190615274565b925092505097509795505050505050565b61ffff86166000908152600560205260408082209051612b4c9088908890614dac565b90815260408051602092819003830190206001600160401b03871660009081529252902054905080612bcc5760405162461bcd60e51b815260206004820152602360248201527f4e6f6e626c6f636b696e674c7a4170703a206e6f2073746f726564206d65737360448201526261676560e81b6064820152608401610d66565b808383604051612bdd929190614dac565b604051809103902014612c3c5760405162461bcd60e51b815260206004820152602160248201527f4e6f6e626c6f636b696e674c7a4170703a20696e76616c6964207061796c6f616044820152601960fa1b6064820152608401610d66565b61ffff87166000908152600560205260408082209051612c5f9089908990614dac565b90815260408051602092819003830181206001600160401b038916600090815290845282902093909355601f88018290048202830182019052868252612cf7918991899089908190840183828082843760009201919091525050604080516020601f8a018190048102820181019092528881528a9350915088908890819084018382808284376000920191909152506126e392505050565b7fc264d91f3adc5588250e1551f547752ca0cfa8f6b530d243b9f9f4cab10ea8e58787878785604051612d2e959493929190615298565b60405180910390a150505050505050565b6000612d49613a12565b6040516370a0823160e01b81526001600160a01b0384811660048301526000917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612db4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612dd89190614e02565b9050306001600160a01b03861603612e2357612e1e6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016858561267b565b612e58565b612e586001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016868686613a99565b6040516370a0823160e01b81526001600160a01b03858116600483015282917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612ec2573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612ee69190614e02565b612ef09190614e31565b95945050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6000606060008060008661ffff166001600160401b03811115612f7757612f776147dc565b6040519080825280601f01601f191660200182016040528015612fa1576020820181803683370190505b50905060008087516020890160008d8df191503d925086831115612fc3578692505b828152826000602083013e909890975095505050505050565b8180519060200120600560008761ffff1661ffff1681526020019081526020016000208560405161300d9190614ee4565b9081526040805191829003602090810183206001600160401b0388166000908152915220919091557fe183f33de2837795525b4792ca4cd60535bd77c53b7e7030060bfcf5734d6b0c9061306a90879087908790879087906152d3565b60405180910390a15050505050565b60408051602081019091526000815260405180602001604052806130a1856000015185613ad1565b90529392505050565b8051600090610f1590670de0b6b3a76400009061533b565b6000806130ef7f00000000000000000000000000000000000000000000000000000000000000008461533b565b90506001600160401b03811115610f155760405162461bcd60e51b815260206004820152601a60248201527f4f4654436f72653a20616d6f756e745344206f766572666c6f770000000000006044820152606401610d66565b60005460ff166114055760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610d66565b60006131e6826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316613add9092919063ffffffff16565b9050805160001480613207575080806020019051810190613207919061534f565b6126de5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610d66565b6000613273826001614e44565b835110156132b95760405162461bcd60e51b8152602060048201526013602482015272746f55696e74385f6f75744f66426f756e647360681b6044820152606401610d66565b50016001015190565b6000806132ce83613aec565b90925090506001600160a01b0382166132e75761dead91505b60006132f282613b71565b90506132ff878483613ba6565b9050826001600160a01b03168761ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8360405161334191815260200190565b60405180910390a350505050505050565b600080600080600061336386613c45565b945094509450945094506000600660008b61ffff1661ffff168152602001908152602001600020896040516133989190614ee4565b90815260408051602092819003830190206001600160401b038b166000908152925281205460ff1691506133cb85613b71565b905081613439576133dd8b3083613ba6565b61ffff8c16600090815260066020526040908190209051919250600191613405908d90614ee4565b90815260408051602092819003830190206001600160401b038d16600090815292529020805460ff19169115159190911790555b6001600160a01b0386163b613490576040516001600160a01b03871681527f9aedf5fdba8716db3b6705ca00150643309995d4f818a249ed6dde6677e7792d9060200160405180910390a15050505050505061172f565b8a8a8a8a8a8a868a60008a6134ae578b6001600160401b03166134b0565b5a5b90506000806134e25a609663eaffd49a60e01b8e8e8e8d8d8d8d8d60405160240161246c98979695949392919061536c565b91509150811561353b578751602089012060405161ffff8d16907fb8890edbfc1c74692f527444645f95489c3703cc2df42e4a366f5d06fa6cd8849061352d908e908e9086906153e0565b60405180910390a250613548565b6135488b8b8b8b85612fdc565b50505050505050505050505050505050505050505050565b600061356b83613cfc565b61ffff808716600090815260026020908152604080832093891683529290522054909150806135dc5760405162461bcd60e51b815260206004820152601a60248201527f4c7a4170703a206d696e4761734c696d6974206e6f74207365740000000000006044820152606401610d66565b6135e68382614e44565b8210156118095760405162461bcd60e51b815260206004820152601b60248201527f4c7a4170703a20676173206c696d697420697320746f6f206c6f7700000000006044820152606401610d66565b6000806136627f00000000000000000000000000000000000000000000000000000000000000008461540e565b905061366e8184614e31565b9150915091565b600061367f613a12565b6001600160a01b03851633146136e25760405162461bcd60e51b815260206004820152602260248201527f50726f78794f46543a206f776e6572206973206e6f742073656e642063616c6c60448201526132b960f11b6064820152608401610d66565b6136ed858584613d58565b604051632770a7eb60e21b81526001600160a01b038681166004830152602482018490527f00000000000000000000000000000000000000000000000000000000000000001690639dc29fac90604401600060405180830381600087803b15801561375757600080fd5b505af115801561376b573d6000803e3d6000fd5b5093979650505050505050565b61ffff86166000908152600160205260408120805461379690614d78565b80601f01602080910402602001604051908101604052809291908181526020018280546137c290614d78565b801561380f5780601f106137e45761010080835404028352916020019161380f565b820191906000526020600020905b8154815290600101906020018083116137f257829003601f168201915b5050505050905080516000036138805760405162461bcd60e51b815260206004820152603060248201527f4c7a4170703a2064657374696e6174696f6e20636861696e206973206e6f742060448201526f61207472757374656420736f7572636560801b6064820152608401610d66565b61388b878751613f7a565b60405162c5803160e81b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063c58031009084906138e2908b9086908c908c908c908c90600401615422565b6000604051808303818588803b1580156138fb57600080fd5b505af115801561390f573d6000803e3d6000fd5b505050505050505050505050565b6000613935896001846001600160401b038916613560565b61393e87613635565b50905061394d8a8a8a84613675565b90506000811161399b5760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006139ab338a612a7a856130c2565b90506139bb8a8287878734613778565b888b6001600160a01b03168b61ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a856040516139fc91815260200190565b60405180910390a4509998505050505050505050565b60005460ff16156114055760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610d66565b6060600185856001600160a01b0389168587604051602001613a7f96959493929190615489565b604051602081830303815290604052905095945050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261172f9085906323b872dd60e01b906084016126a7565b6000611d3b82846154ea565b606061243c8484600085613feb565b60008080613afa8482613266565b60ff16148015613b0b575082516029145b613b525760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613b5d83600d6140c6565b9150613b6a83602161412b565b9050915091565b6000610f157f00000000000000000000000000000000000000000000000000000000000000006001600160401b0384166154ea565b6000613bb0613a12565b613bbb838584614188565b6040516340c10f1960e01b81526001600160a01b038481166004830152602482018490527f000000000000000000000000000000000000000000000000000000000000000016906340c10f1990604401600060405180830381600087803b158015613c2557600080fd5b505af1158015613c39573d6000803e3d6000fd5b50939695505050505050565b600080806060816001613c588783613266565b60ff1614613ca35760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613cae86600d6140c6565b9350613cbb86602161412b565b9250613cc88660296143aa565b9450613cd586604961412b565b9050613cf16051808851613ce99190614e31565b88919061295a565b915091939590929450565b6000602282511015613d505760405162461bcd60e51b815260206004820152601c60248201527f4c7a4170703a20696e76616c69642061646170746572506172616d73000000006044820152606401610d66565b506022015190565b6001600160a01b03831660009081526010602052604090205460ff168015613d805750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015613e0d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e319190614e02565b90529050613e3f818561251d565b61ffff86166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054939550429390919081871115613ec85760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b62015180613ed68587614e31565b1115613efa5761ffff8a166000908152600b60205260409020859055869250613f07565b613f048784614e44565b92505b80831115613f575760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600a602052604090209690965550505050505050565b61ffff821660009081526003602052604081205490819003613f9b57506127105b808211156126de5760405162461bcd60e51b815260206004820181905260248201527f4c7a4170703a207061796c6f61642073697a6520697320746f6f206c617267656044820152606401610d66565b60608247101561404c5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610d66565b600080866001600160a01b031685876040516140689190614ee4565b60006040518083038185875af1925050503d80600081146140a5576040519150601f19603f3d011682016040523d82523d6000602084013e6140aa565b606091505b50915091506140bb87838387614408565b979650505050505050565b60006140d3826014614e44565b8351101561411b5760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b6044820152606401610d66565b500160200151600160601b900490565b6000614138826008614e44565b8351101561417f5760405162461bcd60e51b8152602060048201526014602482015273746f55696e7436345f6f75744f66426f756e647360601b6044820152606401610d66565b50016008015190565b6001600160a01b03831660009081526010602052604090205460ff1680156141b05750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa15801561423d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906142619190614e02565b9052905061426f818561251d565b61ffff86166000908152600f6020908152604080832054600e835281842054600c845282852054600d90945291909320549395504293909190818711156142f85760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b620151806143068587614e31565b111561432a5761ffff8a166000908152600f60205260409020859055869250614337565b6143348784614e44565b92505b808311156143875760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600e602052604090209690965550505050505050565b60006143b7826020614e44565b835110156143ff5760405162461bcd60e51b8152602060048201526015602482015274746f427974657333325f6f75744f66426f756e647360581b6044820152606401610d66565b50016020015190565b60608315614477578251600003614470576001600160a01b0385163b6144705760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610d66565b508161243c565b61243c838381511561448c5781518083602001fd5b8060405162461bcd60e51b8152600401610d669190614a05565b5080546144b290614d78565b6000825580601f106144c2575050565b601f01602090049060005260206000209081019061238e91905b808211156144f057600081556001016144dc565b5090565b803561ffff8116811461450657600080fd5b919050565b60008083601f84011261451d57600080fd5b5081356001600160401b0381111561453457600080fd5b60208301915083602082850101111561454c57600080fd5b9250929050565b80356001600160401b038116811461450657600080fd5b6000806000806000806080878903121561458357600080fd5b61458c876144f4565b955060208701356001600160401b03808211156145a857600080fd5b6145b48a838b0161450b565b90975095508591506145c860408a01614553565b945060608901359150808211156145de57600080fd5b506145eb89828a0161450b565b979a9699509497509295939492505050565b60006020828403121561460f57600080fd5b81356001600160e01b031981168114611d3b57600080fd5b60006020828403121561463957600080fd5b611d3b826144f4565b6000806040838503121561465557600080fd5b61465e836144f4565b946020939093013593505050565b6001600160a01b038116811461238e57600080fd5b60008060006060848603121561469657600080fd5b83356146a18161466c565b92506146af602085016144f4565b9150604084013590509250925092565b801515811461238e57600080fd5b60008060008060008060a087890312156146e657600080fd5b6146ef876144f4565b95506020870135945060408701359350606087013561470d816146bf565b925060808701356001600160401b0381111561472857600080fd5b6145eb89828a0161450b565b60008060006040848603121561474957600080fd5b614752846144f4565b925060208401356001600160401b0381111561476d57600080fd5b6147798682870161450b565b9497909650939450505050565b60006020828403121561479857600080fd5b8135611d3b816146bf565b600080604083850312156147b657600080fd5b82356147c18161466c565b915060208301356147d1816146bf565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561481a5761481a6147dc565b604052919050565b60006001600160401b0382111561483b5761483b6147dc565b50601f01601f191660200190565b60008060006060848603121561485e57600080fd5b614867846144f4565b925060208401356001600160401b0381111561488257600080fd5b8401601f8101861361489357600080fd5b80356148a66148a182614822565b6147f2565b8181528760208385010111156148bb57600080fd5b816020840160208301376000602083830101528094505050506148e060408501614553565b90509250925092565b6000806000606084860312156148fe57600080fd5b83356149098161466c565b925060208401356149198161466c565b929592945050506040919091013590565b60006060828403121561493c57600080fd5b50919050565b600080600080600060a0868803121561495a57600080fd5b85356149658161466c565b9450614973602087016144f4565b9350604086013592506060860135915060808601356001600160401b0381111561499c57600080fd5b6149a88882890161492a565b9150509295509295909350565b60005b838110156149d05781810151838201526020016149b8565b50506000910152565b600081518084526149f18160208601602086016149b5565b601f01601f19169290920160200192915050565b602081526000611d3b60208301846149d9565b60008060008060008060008060e0898b031215614a3457600080fd5b8835614a3f8161466c565b9750614a4d60208a016144f4565b9650604089013595506060890135945060808901356001600160401b0380821115614a7757600080fd5b614a838c838d0161450b565b9096509450849150614a9760a08c01614553565b935060c08b0135915080821115614aad57600080fd5b50614aba8b828c0161492a565b9150509295985092959890939650565b600060208284031215614adc57600080fd5b8135611d3b8161466c565b60008060408385031215614afa57600080fd5b614b03836144f4565b9150614b11602084016144f4565b90509250929050565b600080600080600080600080600060e08a8c031215614b3857600080fd5b614b418a6144f4565b985060208a0135975060408a0135965060608a01356001600160401b0380821115614b6b57600080fd5b614b778d838e0161450b565b9098509650869150614b8b60808d01614553565b955060a08c01359150614b9d826146bf565b90935060c08b01359080821115614bb357600080fd5b50614bc08c828d0161450b565b915080935050809150509295985092959850929598565b600080600080600060808688031215614bef57600080fd5b614bf8866144f4565b9450614c06602087016144f4565b93506040860135925060608601356001600160401b03811115614c2857600080fd5b614c348882890161450b565b969995985093965092949392505050565b600080600060608486031215614c5a57600080fd5b6146a1846144f4565b6000806000806000806000806000806101008b8d031215614c8357600080fd5b614c8c8b6144f4565b995060208b01356001600160401b0380821115614ca857600080fd5b614cb48e838f0161450b565b909b509950899150614cc860408e01614553565b985060608d0135975060808d01359150614ce18261466c565b90955060a08c0135945060c08c01359080821115614cfe57600080fd5b50614d0b8d828e0161450b565b9150809450508092505060e08b013590509295989b9194979a5092959850565b60008060008060808587031215614d4157600080fd5b614d4a856144f4565b9350614d58602086016144f4565b92506040850135614d688161466c565b9396929550929360600135925050565b600181811c90821680614d8c57607f821691505b60208210810361493c57634e487b7160e01b600052602260045260246000fd5b8183823760009101908152919050565b60208082526026908201527f4c7a4170703a20696e76616c696420736f757263652073656e64696e6720636f6040820152651b9d1c9858dd60d21b606082015260800190565b600060208284031215614e1457600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b81810381811115610f1557610f15614e1b565b80820180821115610f1557610f15614e1b565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff84168152604060208201526000612439604083018486614e57565b6000808335601e19843603018112614eb557600080fd5b8301803591506001600160401b03821115614ecf57600080fd5b60200191503681900382131561454c57600080fd5b60008251614ef68184602087016149b5565b9190910192915050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b601f8211156126de576000816000526020600020601f850160051c81016020861015614f4f5750805b601f850160051c820191505b8181101561180957828155600101614f5b565b81516001600160401b03811115614f8757614f876147dc565b614f9b81614f958454614d78565b84614f26565b602080601f831160018114614fd05760008415614fb85750858301515b600019600386901b1c1916600185901b178555611809565b600085815260208120601f198616915b82811015614fff57888601518255948401946001909101908401614fe0565b508582101561501d5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b600061ffff8088168352808716602084015250846040830152608060608301526140bb608083018486614e57565b61ffff8916815260c06020820152600061507960c08301898b614e57565b6001600160401b038816604084015286606084015285608084015282810360a08401526150a7818587614e57565b9b9a5050505050505050505050565b6001600160401b038311156150cd576150cd6147dc565b6150e1836150db8354614d78565b83614f26565b6000601f84116001811461511557600085156150fd5750838201355b600019600387901b1c1916600186901b178355610f9d565b600083815260209020601f19861690835b828110156151465786850135825560209485019460019092019101615126565b50868210156151635760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b60006020828403121561518757600080fd5b81516001600160401b0381111561519d57600080fd5b8201601f810184136151ae57600080fd5b80516151bc6148a182614822565b8181528560208385010111156151d157600080fd5b612ef08260208301602086016149b5565b61ffff851681526080602082015260006151ff60808301866149d9565b6001600160401b038516604084015282810360608401526140bb81856149d9565b61ffff861681526001600160a01b038516602082015260a06040820181905260009061524e908301866149d9565b8415156060840152828103608084015261526881856149d9565b98975050505050505050565b6000806040838503121561528757600080fd5b505080516020909101519092909150565b61ffff861681526080602082015260006152b6608083018688614e57565b6001600160401b0394909416604083015250606001529392505050565b61ffff8616815260a0602082015260006152f060a08301876149d9565b6001600160401b0386166040840152828103606084015261531181866149d9565b9050828103608084015261526881856149d9565b634e487b7160e01b600052601260045260246000fd5b60008261534a5761534a615325565b500490565b60006020828403121561536157600080fd5b8151611d3b816146bf565b600061010061ffff8b16835280602084015261538a8184018b6149d9565b6001600160401b038a166040850152606084018990526001600160a01b038816608085015260a0840187905283810360c085015290506153ca81866149d9565b9150508260e08301529998505050505050505050565b6060815260006153f360608301866149d9565b6001600160401b039490941660208301525060400152919050565b60008261541d5761541d615325565b500690565b61ffff8716815260c06020820152600061543f60c08301886149d9565b828103604084015261545181886149d9565b6001600160a01b0387811660608601528616608085015283810360a0850152905061547c81856149d9565b9998505050505050505050565b60ff60f81b8760f81b16815285600182015260006001600160401b0360c01b808760c01b166021840152856029840152808560c01b1660498401525082516154d88160518501602087016149b5565b91909101605101979650505050505050565b8082028115828204841417610f1557610f15614e1b56fea264697066735822122078a20abcb22d7cb1fa2db0ea891c1e652ab0382a5180ce86b54f25c83dc77a1264736f6c63430008190033", + "deployedBytecode": "0x6080604052600436106103b75760003560e01c80637dc0d1d0116101f2578063baf3292d1161010d578063df2a5b3b116100a0578063f2fde38b1161006f578063f2fde38b14610c52578063f5ecbdbc14610c72578063fc0c546a14610c92578063fdff235b14610cc557600080fd5b8063df2a5b3b14610bdd578063e6a20ae614610bfd578063eaffd49a14610c12578063eb8d72b714610c3257600080fd5b8063cc01e9b6116100dc578063cc01e9b614610b50578063cc7015ae14610b70578063d1deba1f14610b9d578063d708a46814610bb057600080fd5b8063baf3292d14610ae0578063c1e9132e14610b00578063c446183414610b1a578063cbed8b9c14610b3057600080fd5b806393a61d6c116101855780639f38369a116101545780639f38369a14610a4c578063a4c51df514610a6c578063a6c3d16514610a8c578063b353aaa714610aac57600080fd5b806393a61d6c1461097d578063950c8a74146109aa5780639b19251a146109ca5780639bdb9812146109fa57600080fd5b80638cfd8f5c116101c15780638cfd8f5c146108e05780638da5cb5b14610918578063904365671461093b5780639358928b1461096857600080fd5b80637dc0d1d01461083a5780638456cb591461087757806384e69c691461088c578063857749b0146108ac57600080fd5b80634c42899a116102e257806364aff9ec11610275578063715018a611610244578063715018a6146107ce5780637533d788146107da57806376203b48146108075780637adbf9731461081a57600080fd5b806364aff9ec1461075b57806366ad5c8a1461077b578063695ef6bf1461079b57806369c1e7b8146107ae57600080fd5b806353489d6c116102b157806353489d6c146106b457806353d6fd59146106d45780635b8c41e6146106f45780635c975abb1461074357600080fd5b80634c42899a146106135780634cec62561461063a5780634ed2c662146106675780634f4ba0f41461068757600080fd5b80632dbbec081161035a5780633f1f4fa4116103295780633f1f4fa41461059c5780633f4ba83a146105c957806342d65a8d146105de57806344770515146105fe57600080fd5b80632dbbec08146104ec578063365260b41461050c5780633c4ec39b146105415780633d8b38f61461057c57600080fd5b80630df37483116103965780630df374831461043357806310ddb13714610453578063182b4b89146104735780632488eec8146104cc57600080fd5b80621d3567146103bc57806301ffc9a7146103de57806307e0db1714610413575b600080fd5b3480156103c857600080fd5b506103dc6103d736600461456a565b610cf2565b005b3480156103ea57600080fd5b506103fe6103f93660046145fd565b610ee4565b60405190151581526020015b60405180910390f35b34801561041f57600080fd5b506103dc61042e366004614627565b610f1b565b34801561043f57600080fd5b506103dc61044e366004614642565b610fa4565b34801561045f57600080fd5b506103dc61046e366004614627565b610fc3565b34801561047f57600080fd5b5061049361048e366004614681565b61101b565b6040805197151588526020880196909652948601939093526060850191909152608084015260a0830152151560c082015260e00161040a565b3480156104d857600080fd5b506103dc6104e7366004614642565b611191565b3480156104f857600080fd5b506103dc610507366004614627565b611275565b34801561051857600080fd5b5061052c6105273660046146cd565b6112d4565b6040805192835260208301919091520161040a565b34801561054d57600080fd5b5061056e61055c366004614627565b600d6020526000908152604090205481565b60405190815260200161040a565b34801561058857600080fd5b506103fe610597366004614734565b611329565b3480156105a857600080fd5b5061056e6105b7366004614627565b60036020526000908152604090205481565b3480156105d557600080fd5b506103dc6113f5565b3480156105ea57600080fd5b506103dc6105f9366004614734565b611407565b34801561060a57600080fd5b5061056e600081565b34801561061f57600080fd5b50610628600081565b60405160ff909116815260200161040a565b34801561064657600080fd5b5061056e610655366004614627565b600a6020526000908152604090205481565b34801561067357600080fd5b506103dc610682366004614786565b61148d565b34801561069357600080fd5b5061056e6106a2366004614627565b60096020526000908152604090205481565b3480156106c057600080fd5b506103dc6106cf366004614642565b6114d2565b3480156106e057600080fd5b506103dc6106ef3660046147a3565b6115b6565b34801561070057600080fd5b5061056e61070f366004614849565b6005602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205481565b34801561074f57600080fd5b5060005460ff166103fe565b34801561076757600080fd5b506103dc6107763660046148e9565b61162e565b34801561078757600080fd5b506103dc61079636600461456a565b611735565b6103dc6107a9366004614942565b611811565b3480156107ba57600080fd5b506103dc6107c9366004614642565b61187c565b3480156103dc57600080fd5b3480156107e657600080fd5b506107fa6107f5366004614627565b611968565b60405161040a9190614a05565b6103dc610815366004614a18565b611a02565b34801561082657600080fd5b506103dc610835366004614aca565b611a6e565b34801561084657600080fd5b5060075461085f9061010090046001600160a01b031681565b6040516001600160a01b03909116815260200161040a565b34801561088357600080fd5b506103dc611ae6565b34801561089857600080fd5b506103dc6108a7366004614849565b611af6565b3480156108b857600080fd5b506106287f000000000000000000000000000000000000000000000000000000000000000081565b3480156108ec57600080fd5b5061056e6108fb366004614ae7565b600260209081526000928352604080842090915290825290205481565b34801561092457600080fd5b5060005461010090046001600160a01b031661085f565b34801561094757600080fd5b5061056e610956366004614627565b600c6020526000908152604090205481565b34801561097457600080fd5b5061056e611ba3565b34801561098957600080fd5b5061056e610998366004614627565b600b6020526000908152604090205481565b3480156109b657600080fd5b5060045461085f906001600160a01b031681565b3480156109d657600080fd5b506103fe6109e5366004614aca565b60106020526000908152604090205460ff1681565b348015610a0657600080fd5b506103fe610a15366004614849565b6006602090815260009384526040808520845180860184018051928152908401958401959095209452929052825290205460ff1681565b348015610a5857600080fd5b506107fa610a67366004614627565b611c2c565b348015610a7857600080fd5b5061052c610a87366004614b1a565b611d42565b348015610a9857600080fd5b506103dc610aa7366004614734565b611dd1565b348015610ab857600080fd5b5061085f7f000000000000000000000000000000000000000000000000000000000000000081565b348015610aec57600080fd5b506103dc610afb366004614aca565b611e5a565b348015610b0c57600080fd5b506007546103fe9060ff1681565b348015610b2657600080fd5b5061056e61271081565b348015610b3c57600080fd5b506103dc610b4b366004614bd7565b611eb0565b348015610b5c57600080fd5b506103dc610b6b366004614642565b611f45565b348015610b7c57600080fd5b5061056e610b8b366004614627565b60086020526000908152604090205481565b6103dc610bab36600461456a565b612031565b348015610bbc57600080fd5b5061056e610bcb366004614627565b600e6020526000908152604090205481565b348015610be957600080fd5b506103dc610bf8366004614c45565b612135565b348015610c0957600080fd5b50610628600181565b348015610c1e57600080fd5b506103dc610c2d366004614c63565b61219f565b348015610c3e57600080fd5b506103dc610c4d366004614734565b6122be565b348015610c5e57600080fd5b506103dc610c6d366004614aca565b612318565b348015610c7e57600080fd5b506107fa610c8d366004614d2b565b612391565b348015610c9e57600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061085f565b348015610cd157600080fd5b5061056e610ce0366004614627565b600f6020526000908152604090205481565b337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031614610d6f5760405162461bcd60e51b815260206004820152601e60248201527f4c7a4170703a20696e76616c696420656e64706f696e742063616c6c6572000060448201526064015b60405180910390fd5b61ffff861660009081526001602052604081208054610d8d90614d78565b80601f0160208091040260200160405190810160405280929190818152602001828054610db990614d78565b8015610e065780601f10610ddb57610100808354040283529160200191610e06565b820191906000526020600020905b815481529060010190602001808311610de957829003601f168201915b50505050509050805186869050148015610e21575060008151115b8015610e49575080516020820120604051610e3f9088908890614dac565b6040518091039020145b610e655760405162461bcd60e51b8152600401610d6690614dbc565b610edb8787878080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8a018190048102820181019092528881528a93509150889088908190840183828082843760009201919091525061244492505050565b50505050505050565b60006001600160e01b03198216631f7ecdf760e01b1480610f1557506301ffc9a760e01b6001600160e01b03198316145b92915050565b610f236124bd565b6040516307e0db1760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906307e0db17906024015b600060405180830381600087803b158015610f8957600080fd5b505af1158015610f9d573d6000803e3d6000fd5b5050505050565b610fac6124bd565b61ffff909116600090815260036020526040902055565b610fcb6124bd565b6040516310ddb13760e01b815261ffff821660048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906310ddb13790602401610f6f565b6001600160a01b03838116600090815260106020908152604080832054815192830190915260075492938493849384938493849360ff909216928492909182916101009004166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156110cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110ef9190614e02565b905290506110fd818a61251d565b61ffff8b166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054919a509098509196509094509250426201518061114b8583614e31565b111561115c57859450809350611169565b6111668686614e44565b94505b828061118057508786111580156111805750868511155b985050509397509397509397909450565b6111996124bd565b61ffff821660009081526008602052604090205481101561120b5760405162461bcd60e51b815260206004820152602660248201527f4461696c79206c696d6974203c2073696e676c65207472616e73616374696f6e604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600960209081526040918290205482519384529083015281018290527f4dd31065e259d5284e44d1f9265710da72eafcf78dc925e3881189fc3b71f6939060600160405180910390a161ffff909116600090815260096020526040902055565b61127d6124bd565b61ffff81166000908152600160205260408120611299916144a6565b60405161ffff821681527f6d5075c81d4d9e75bec6052f4e44f58f8a8cf1327544addbbf015fb06f83bd37906020015b60405180910390a150565b60008061131a8888888888888080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061253592505050565b91509150965096945050505050565b61ffff83166000908152600160205260408120805482919061134a90614d78565b80601f016020809104026020016040519081016040528092919081815260200182805461137690614d78565b80156113c35780601f10611398576101008083540402835291602001916113c3565b820191906000526020600020905b8154815290600101906020018083116113a657829003601f168201915b5050505050905083836040516113da929190614dac565b60405180910390208180519060200120149150509392505050565b6113fd6124bd565b611405612629565b565b61140f6124bd565b6040516342d65a8d60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906342d65a8d9061145f90869086908690600401614e80565b600060405180830381600087803b15801561147957600080fd5b505af1158015610edb573d6000803e3d6000fd5b6114956124bd565b6007805460ff19168215159081179091556040517fe628f01c6f4e6340598d3a2913390db68e8859379eebff349e170f2b16baed0090600090a250565b6114da6124bd565b61ffff821660009081526009602052604090205481111561154c5760405162461bcd60e51b815260206004820152602660248201527f53696e676c65207472616e73616374696f6e206c696d6974203e204461696c79604482015265081b1a5b5a5d60d21b6064820152608401610d66565b61ffff82166000818152600860209081526040918290205482519384529083015281018290527f7babeac42ccbb33537ee421fedc4db7b5f251b5d2a3fa5c0ff4b35b2d783be879060600160405180910390a161ffff909116600090815260086020526040902055565b6115be6124bd565b816001600160a01b03167ff6019ec0a78d156d249a1ec7579e2321f6ac7521d6e1d2eacf90ba4a184dcceb826040516115fb911515815260200190565b60405180910390a26001600160a01b03919091166000908152601060205260409020805460ff1916911515919091179055565b6116366124bd565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a0823190602401602060405180830381865afa15801561167d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a19190614e02565b9050808211156116ce5760405163cf47918160e01b81526004810183905260248101829052604401610d66565b826001600160a01b0316846001600160a01b03167f6d25be279134f4ecaa4770aff0c3d916d9e7c5ef37b65ed95dbdba411f5d54d58460405161171391815260200190565b60405180910390a361172f6001600160a01b038516848461267b565b50505050565b3330146117935760405162461bcd60e51b815260206004820152602660248201527f4e6f6e626c6f636b696e674c7a4170703a2063616c6c6572206d7573742062656044820152650204c7a4170760d41b6064820152608401610d66565b6118098686868080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8901819004810282018101909252878152899350915087908790819084018382808284376000920191909152506126e392505050565b505050505050565b611809858585856118256020870187614aca565b6118356040880160208901614aca565b6118426040890189614e9e565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061276a92505050565b6118846124bd565b61ffff82166000908152600c60205260409020548110156118fe5760405162461bcd60e51b815260206004820152602e60248201527f4461696c79206c696d6974203c2073696e676c6520726563656976652074726160448201526d1b9cd858dd1a5bdb881b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600d60209081526040918290205482519384529083015281018290527f95dc51094cd27cf4ee3fd0dbb50cf96f8df1629c822f5434c4a34d7eb03c97249060600160405180910390a161ffff9091166000908152600d6020526040902055565b6001602052600090815260409020805461198190614d78565b80601f01602080910402602001604051908101604052809291908181526020018280546119ad90614d78565b80156119fa5780601f106119cf576101008083540402835291602001916119fa565b820191906000526020600020905b8154815290600101906020018083116119dd57829003601f168201915b505050505081565b60075460ff16611a545760405162461bcd60e51b815260206004820152601760248201527f73656e64416e6443616c6c2069732064697361626c65640000000000000000006044820152606401610d66565b611a648888888888888888612852565b5050505050505050565b611a766124bd565b611a7f816128f6565b6007546040516001600160a01b0380841692610100900416907f05cd89403c6bdeac21c2ff33de395121a31fa1bc2bf3adf4825f1f86e79969dd90600090a3600780546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b611aee6124bd565b61140561291d565b611afe6124bd565b61ffff83166000908152600560205260408082209051611b1f908590614ee4565b9081526040805191829003602090810183206001600160401b038616600090815291522091909155611b52908390614ee4565b6040805191829003822061ffff861683526001600160401b0384166020840152917f48a980eea4ea1c540209e2f9f32a4c2edf51fab37b1d21f453868301ecb6e2ee910160405180910390a2505050565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c03573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c279190614e02565b905090565b61ffff8116600090815260016020526040812080546060929190611c4f90614d78565b80601f0160208091040260200160405190810160405280929190818152602001828054611c7b90614d78565b8015611cc85780601f10611c9d57610100808354040283529160200191611cc8565b820191906000526020600020905b815481529060010190602001808311611cab57829003601f168201915b505050505090508051600003611d205760405162461bcd60e51b815260206004820152601d60248201527f4c7a4170703a206e6f20747275737465642070617468207265636f72640000006044820152606401610d66565b611d3b600060148351611d339190614e31565b83919061295a565b9392505050565b600080611dbf8b8b8b8b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b81528e93508d9250908c908c9081908401838280828437600092019190915250612a6792505050565b91509150995099975050505050505050565b611dd96124bd565b818130604051602001611dee93929190614f00565b60408051601f1981840301815291815261ffff8516600090815260016020522090611e199082614f6e565b507f8c0400cfe2d1199b1a725c78960bcc2a344d869b80590d0f2bd005db15a572ce838383604051611e4d93929190614e80565b60405180910390a1505050565b611e626124bd565b600480546001600160a01b0319166001600160a01b0383169081179091556040519081527f5db758e995a17ec1ad84bdef7e8c3293a0bd6179bcce400dff5d4c3d87db726b906020016112c9565b611eb86124bd565b6040516332fb62e760e21b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cbed8b9c90611f0c908890889088908890889060040161502d565b600060405180830381600087803b158015611f2657600080fd5b505af1158015611f3a573d6000803e3d6000fd5b505050505050505050565b611f4d6124bd565b61ffff82166000908152600d6020526040902054811115611fc75760405162461bcd60e51b815260206004820152602e60248201527f73696e676c652072656365697665207472616e73616374696f6e206c696d697460448201526d080f8811185a5b1e481b1a5b5a5d60921b6064820152608401610d66565b61ffff82166000818152600c60209081526040918290205482519384529083015281018290527f2c42997a938a029910a78e7c28d762b349c28e70f3a89c1fbccbb1a46020b1599060600160405180910390a161ffff9091166000908152600c6020526040902055565b61ffff86166000908152600160205260408120805461204f90614d78565b80601f016020809104026020016040519081016040528092919081815260200182805461207b90614d78565b80156120c85780601f1061209d576101008083540402835291602001916120c8565b820191906000526020600020905b8154815290600101906020018083116120ab57829003601f168201915b505050505090508051868690501480156120e3575060008151115b801561210b5750805160208201206040516121019088908890614dac565b6040518091039020145b6121275760405162461bcd60e51b8152600401610d6690614dbc565b610edb878787878787612b29565b61213d6124bd565b61ffff83811660008181526002602090815260408083209487168084529482529182902085905581519283528201929092529081018290527f9d5c7c0b934da8fefa9c7760c98383778a12dfbfc0c3b3106518f43fb9508ac090606001611e4d565b3330146121ee5760405162461bcd60e51b815260206004820152601f60248201527f4f4654436f72653a2063616c6c6572206d757374206265204f4654436f7265006044820152606401610d66565b6121f9308686612d3f565b9350846001600160a01b03168a61ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8660405161223b91815260200190565b60405180910390a3604051633fe79aed60e11b81526001600160a01b03861690637fcf35da90839061227f908e908e908e908e908e908d908d908d9060040161505b565b600060405180830381600088803b15801561229957600080fd5b5087f11580156122ad573d6000803e3d6000fd5b505050505050505050505050505050565b6122c66124bd565b61ffff831660009081526001602052604090206122e48284836150b6565b507ffa41487ad5d6728f0b19276fa1eddc16558578f5109fc39d2dc33c3230470dab838383604051611e4d93929190614e80565b6123206124bd565b6001600160a01b0381166123855760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d66565b61238e81612ef9565b50565b604051633d7b2f6f60e21b815261ffff808616600483015284166024820152306044820152606481018290526060907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03169063f5ecbdbc90608401600060405180830381865afa158015612411573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526124399190810190615175565b90505b949350505050565b6000806124a75a60966366ad5c8a60e01b8989898960405160240161246c94939291906151e2565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915230929190612f52565b9150915081611809576118098686868685612fdc565b6000546001600160a01b036101009091041633146114055760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d66565b60008061252a8484613079565b905061243c816130aa565b600080600061258387612547886130c2565b6040805160006020820152602181019390935260c09190911b6001600160c01b0319166041830152805160298184030181526049909201905290565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb10906125da908b90309086908b908b90600401615220565b6040805180830381865afa1580156125f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061261a9190615274565b92509250509550959350505050565b612631613148565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6040516001600160a01b0383166024820152604481018290526126de90849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152613191565b505050565b60006126ef8282613266565b905060ff811661270a57612705858585856132c2565b610f9d565b60001960ff8216016127225761270585858585613352565b60405162461bcd60e51b815260206004820152601c60248201527f4f4654436f72653a20756e6b6e6f776e207061636b65742074797065000000006044820152606401610d66565b600061277887828481613560565b61278185613635565b50905061279088888884613675565b9050600081116127de5760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006127ed87612547846130c2565b90506127fd888287878734613778565b86896001600160a01b03168961ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a8560405161283e91815260200190565b60405180910390a450979650505050505050565b611f3a8888888888888080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a925061289f9150506020890189614aca565b6128af60408a0160208b01614aca565b6128bc60408b018b614e9e565b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061391d92505050565b6001600160a01b03811661238e576040516342bcdf7f60e11b815260040160405180910390fd5b612925613a12565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25861265e3390565b60608161296881601f614e44565b10156129a75760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b6044820152606401610d66565b6129b18284614e44565b845110156129f55760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b6044820152606401610d66565b606082158015612a145760405191506000825260208201604052612a5e565b6040519150601f8416801560200281840101858101878315602002848b0101015b81831015612a4d578051835260209283019201612a35565b5050858452601f01601f1916604052505b50949350505050565b6000806000612a81338a612a7a8b6130c2565b8a8a613a58565b60405163040a7bb160e41b81529091506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906340a7bb1090612ad8908d90309086908b908b90600401615220565b6040805180830381865afa158015612af4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b189190615274565b925092505097509795505050505050565b61ffff86166000908152600560205260408082209051612b4c9088908890614dac565b90815260408051602092819003830190206001600160401b03871660009081529252902054905080612bcc5760405162461bcd60e51b815260206004820152602360248201527f4e6f6e626c6f636b696e674c7a4170703a206e6f2073746f726564206d65737360448201526261676560e81b6064820152608401610d66565b808383604051612bdd929190614dac565b604051809103902014612c3c5760405162461bcd60e51b815260206004820152602160248201527f4e6f6e626c6f636b696e674c7a4170703a20696e76616c6964207061796c6f616044820152601960fa1b6064820152608401610d66565b61ffff87166000908152600560205260408082209051612c5f9089908990614dac565b90815260408051602092819003830181206001600160401b038916600090815290845282902093909355601f88018290048202830182019052868252612cf7918991899089908190840183828082843760009201919091525050604080516020601f8a018190048102820181019092528881528a9350915088908890819084018382808284376000920191909152506126e392505050565b7fc264d91f3adc5588250e1551f547752ca0cfa8f6b530d243b9f9f4cab10ea8e58787878785604051612d2e959493929190615298565b60405180910390a150505050505050565b6000612d49613a12565b6040516370a0823160e01b81526001600160a01b0384811660048301526000917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612db4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612dd89190614e02565b9050306001600160a01b03861603612e2357612e1e6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016858561267b565b612e58565b612e586001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016868686613a99565b6040516370a0823160e01b81526001600160a01b03858116600483015282917f0000000000000000000000000000000000000000000000000000000000000000909116906370a0823190602401602060405180830381865afa158015612ec2573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612ee69190614e02565b612ef09190614e31565b95945050505050565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b6000606060008060008661ffff166001600160401b03811115612f7757612f776147dc565b6040519080825280601f01601f191660200182016040528015612fa1576020820181803683370190505b50905060008087516020890160008d8df191503d925086831115612fc3578692505b828152826000602083013e909890975095505050505050565b8180519060200120600560008761ffff1661ffff1681526020019081526020016000208560405161300d9190614ee4565b9081526040805191829003602090810183206001600160401b0388166000908152915220919091557fe183f33de2837795525b4792ca4cd60535bd77c53b7e7030060bfcf5734d6b0c9061306a90879087908790879087906152d3565b60405180910390a15050505050565b60408051602081019091526000815260405180602001604052806130a1856000015185613ad1565b90529392505050565b8051600090610f1590670de0b6b3a76400009061533b565b6000806130ef7f00000000000000000000000000000000000000000000000000000000000000008461533b565b90506001600160401b03811115610f155760405162461bcd60e51b815260206004820152601a60248201527f4f4654436f72653a20616d6f756e745344206f766572666c6f770000000000006044820152606401610d66565b60005460ff166114055760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610d66565b60006131e6826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316613add9092919063ffffffff16565b9050805160001480613207575080806020019051810190613207919061534f565b6126de5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610d66565b6000613273826001614e44565b835110156132b95760405162461bcd60e51b8152602060048201526013602482015272746f55696e74385f6f75744f66426f756e647360681b6044820152606401610d66565b50016001015190565b6000806132ce83613aec565b90925090506001600160a01b0382166132e75761dead91505b60006132f282613b71565b90506132ff878483613ba6565b9050826001600160a01b03168761ffff167fbf551ec93859b170f9b2141bd9298bf3f64322c6f7beb2543a0cb669834118bf8360405161334191815260200190565b60405180910390a350505050505050565b600080600080600061336386613c45565b945094509450945094506000600660008b61ffff1661ffff168152602001908152602001600020896040516133989190614ee4565b90815260408051602092819003830190206001600160401b038b166000908152925281205460ff1691506133cb85613b71565b905081613439576133dd8b3083613ba6565b61ffff8c16600090815260066020526040908190209051919250600191613405908d90614ee4565b90815260408051602092819003830190206001600160401b038d16600090815292529020805460ff19169115159190911790555b6001600160a01b0386163b613490576040516001600160a01b03871681527f9aedf5fdba8716db3b6705ca00150643309995d4f818a249ed6dde6677e7792d9060200160405180910390a15050505050505061172f565b8a8a8a8a8a8a868a60008a6134ae578b6001600160401b03166134b0565b5a5b90506000806134e25a609663eaffd49a60e01b8e8e8e8d8d8d8d8d60405160240161246c98979695949392919061536c565b91509150811561353b578751602089012060405161ffff8d16907fb8890edbfc1c74692f527444645f95489c3703cc2df42e4a366f5d06fa6cd8849061352d908e908e9086906153e0565b60405180910390a250613548565b6135488b8b8b8b85612fdc565b50505050505050505050505050505050505050505050565b600061356b83613cfc565b61ffff808716600090815260026020908152604080832093891683529290522054909150806135dc5760405162461bcd60e51b815260206004820152601a60248201527f4c7a4170703a206d696e4761734c696d6974206e6f74207365740000000000006044820152606401610d66565b6135e68382614e44565b8210156118095760405162461bcd60e51b815260206004820152601b60248201527f4c7a4170703a20676173206c696d697420697320746f6f206c6f7700000000006044820152606401610d66565b6000806136627f00000000000000000000000000000000000000000000000000000000000000008461540e565b905061366e8184614e31565b9150915091565b600061367f613a12565b6001600160a01b03851633146136e25760405162461bcd60e51b815260206004820152602260248201527f50726f78794f46543a206f776e6572206973206e6f742073656e642063616c6c60448201526132b960f11b6064820152608401610d66565b6136ed858584613d58565b604051632770a7eb60e21b81526001600160a01b038681166004830152602482018490527f00000000000000000000000000000000000000000000000000000000000000001690639dc29fac90604401600060405180830381600087803b15801561375757600080fd5b505af115801561376b573d6000803e3d6000fd5b5093979650505050505050565b61ffff86166000908152600160205260408120805461379690614d78565b80601f01602080910402602001604051908101604052809291908181526020018280546137c290614d78565b801561380f5780601f106137e45761010080835404028352916020019161380f565b820191906000526020600020905b8154815290600101906020018083116137f257829003601f168201915b5050505050905080516000036138805760405162461bcd60e51b815260206004820152603060248201527f4c7a4170703a2064657374696e6174696f6e20636861696e206973206e6f742060448201526f61207472757374656420736f7572636560801b6064820152608401610d66565b61388b878751613f7a565b60405162c5803160e81b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063c58031009084906138e2908b9086908c908c908c908c90600401615422565b6000604051808303818588803b1580156138fb57600080fd5b505af115801561390f573d6000803e3d6000fd5b505050505050505050505050565b6000613935896001846001600160401b038916613560565b61393e87613635565b50905061394d8a8a8a84613675565b90506000811161399b5760405162461bcd60e51b815260206004820152601960248201527813d19510dbdc994e88185b5bdd5b9d081d1bdbc81cdb585b1b603a1b6044820152606401610d66565b60006139ab338a612a7a856130c2565b90506139bb8a8287878734613778565b888b6001600160a01b03168b61ffff167fd81fc9b8523134ed613870ed029d6170cbb73aa6a6bc311b9a642689fb9df59a856040516139fc91815260200190565b60405180910390a4509998505050505050505050565b60005460ff16156114055760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610d66565b6060600185856001600160a01b0389168587604051602001613a7f96959493929190615489565b604051602081830303815290604052905095945050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261172f9085906323b872dd60e01b906084016126a7565b6000611d3b82846154ea565b606061243c8484600085613feb565b60008080613afa8482613266565b60ff16148015613b0b575082516029145b613b525760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613b5d83600d6140c6565b9150613b6a83602161412b565b9050915091565b6000610f157f00000000000000000000000000000000000000000000000000000000000000006001600160401b0384166154ea565b6000613bb0613a12565b613bbb838584614188565b6040516340c10f1960e01b81526001600160a01b038481166004830152602482018490527f000000000000000000000000000000000000000000000000000000000000000016906340c10f1990604401600060405180830381600087803b158015613c2557600080fd5b505af1158015613c39573d6000803e3d6000fd5b50939695505050505050565b600080806060816001613c588783613266565b60ff1614613ca35760405162461bcd60e51b815260206004820152601860248201527713d19510dbdc994e881a5b9d985b1a59081c185e5b1bd85960421b6044820152606401610d66565b613cae86600d6140c6565b9350613cbb86602161412b565b9250613cc88660296143aa565b9450613cd586604961412b565b9050613cf16051808851613ce99190614e31565b88919061295a565b915091939590929450565b6000602282511015613d505760405162461bcd60e51b815260206004820152601c60248201527f4c7a4170703a20696e76616c69642061646170746572506172616d73000000006044820152606401610d66565b506022015190565b6001600160a01b03831660009081526010602052604090205460ff168015613d805750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015613e0d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e319190614e02565b90529050613e3f818561251d565b61ffff86166000908152600b6020908152604080832054600a835281842054600884528285205460099094529190932054939550429390919081871115613ec85760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b62015180613ed68587614e31565b1115613efa5761ffff8a166000908152600b60205260409020859055869250613f07565b613f048784614e44565b92505b80831115613f575760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600a602052604090209690965550505050505050565b61ffff821660009081526003602052604081205490819003613f9b57506127105b808211156126de5760405162461bcd60e51b815260206004820181905260248201527f4c7a4170703a207061796c6f61642073697a6520697320746f6f206c617267656044820152606401610d66565b60608247101561404c5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610d66565b600080866001600160a01b031685876040516140689190614ee4565b60006040518083038185875af1925050503d80600081146140a5576040519150601f19603f3d011682016040523d82523d6000602084013e6140aa565b606091505b50915091506140bb87838387614408565b979650505050505050565b60006140d3826014614e44565b8351101561411b5760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b6044820152606401610d66565b500160200151600160601b900490565b6000614138826008614e44565b8351101561417f5760405162461bcd60e51b8152602060048201526014602482015273746f55696e7436345f6f75744f66426f756e647360601b6044820152606401610d66565b50016008015190565b6001600160a01b03831660009081526010602052604090205460ff1680156141b05750505050565b60408051602081019091526007546000918291819061010090046001600160a01b03166341976e097f00000000000000000000000000000000000000000000000000000000000000006040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa15801561423d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906142619190614e02565b9052905061426f818561251d565b61ffff86166000908152600f6020908152604080832054600e835281842054600c845282852054600d90945291909320549395504293909190818711156142f85760405162461bcd60e51b815260206004820152601f60248201527f53696e676c65205472616e73616374696f6e204c696d697420457863656564006044820152606401610d66565b620151806143068587614e31565b111561432a5761ffff8a166000908152600f60205260409020859055869250614337565b6143348784614e44565b92505b808311156143875760405162461bcd60e51b815260206004820152601e60248201527f4461696c79205472616e73616374696f6e204c696d69742045786365656400006044820152606401610d66565b505061ffff9097166000908152600e602052604090209690965550505050505050565b60006143b7826020614e44565b835110156143ff5760405162461bcd60e51b8152602060048201526015602482015274746f427974657333325f6f75744f66426f756e647360581b6044820152606401610d66565b50016020015190565b60608315614477578251600003614470576001600160a01b0385163b6144705760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610d66565b508161243c565b61243c838381511561448c5781518083602001fd5b8060405162461bcd60e51b8152600401610d669190614a05565b5080546144b290614d78565b6000825580601f106144c2575050565b601f01602090049060005260206000209081019061238e91905b808211156144f057600081556001016144dc565b5090565b803561ffff8116811461450657600080fd5b919050565b60008083601f84011261451d57600080fd5b5081356001600160401b0381111561453457600080fd5b60208301915083602082850101111561454c57600080fd5b9250929050565b80356001600160401b038116811461450657600080fd5b6000806000806000806080878903121561458357600080fd5b61458c876144f4565b955060208701356001600160401b03808211156145a857600080fd5b6145b48a838b0161450b565b90975095508591506145c860408a01614553565b945060608901359150808211156145de57600080fd5b506145eb89828a0161450b565b979a9699509497509295939492505050565b60006020828403121561460f57600080fd5b81356001600160e01b031981168114611d3b57600080fd5b60006020828403121561463957600080fd5b611d3b826144f4565b6000806040838503121561465557600080fd5b61465e836144f4565b946020939093013593505050565b6001600160a01b038116811461238e57600080fd5b60008060006060848603121561469657600080fd5b83356146a18161466c565b92506146af602085016144f4565b9150604084013590509250925092565b801515811461238e57600080fd5b60008060008060008060a087890312156146e657600080fd5b6146ef876144f4565b95506020870135945060408701359350606087013561470d816146bf565b925060808701356001600160401b0381111561472857600080fd5b6145eb89828a0161450b565b60008060006040848603121561474957600080fd5b614752846144f4565b925060208401356001600160401b0381111561476d57600080fd5b6147798682870161450b565b9497909650939450505050565b60006020828403121561479857600080fd5b8135611d3b816146bf565b600080604083850312156147b657600080fd5b82356147c18161466c565b915060208301356147d1816146bf565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561481a5761481a6147dc565b604052919050565b60006001600160401b0382111561483b5761483b6147dc565b50601f01601f191660200190565b60008060006060848603121561485e57600080fd5b614867846144f4565b925060208401356001600160401b0381111561488257600080fd5b8401601f8101861361489357600080fd5b80356148a66148a182614822565b6147f2565b8181528760208385010111156148bb57600080fd5b816020840160208301376000602083830101528094505050506148e060408501614553565b90509250925092565b6000806000606084860312156148fe57600080fd5b83356149098161466c565b925060208401356149198161466c565b929592945050506040919091013590565b60006060828403121561493c57600080fd5b50919050565b600080600080600060a0868803121561495a57600080fd5b85356149658161466c565b9450614973602087016144f4565b9350604086013592506060860135915060808601356001600160401b0381111561499c57600080fd5b6149a88882890161492a565b9150509295509295909350565b60005b838110156149d05781810151838201526020016149b8565b50506000910152565b600081518084526149f18160208601602086016149b5565b601f01601f19169290920160200192915050565b602081526000611d3b60208301846149d9565b60008060008060008060008060e0898b031215614a3457600080fd5b8835614a3f8161466c565b9750614a4d60208a016144f4565b9650604089013595506060890135945060808901356001600160401b0380821115614a7757600080fd5b614a838c838d0161450b565b9096509450849150614a9760a08c01614553565b935060c08b0135915080821115614aad57600080fd5b50614aba8b828c0161492a565b9150509295985092959890939650565b600060208284031215614adc57600080fd5b8135611d3b8161466c565b60008060408385031215614afa57600080fd5b614b03836144f4565b9150614b11602084016144f4565b90509250929050565b600080600080600080600080600060e08a8c031215614b3857600080fd5b614b418a6144f4565b985060208a0135975060408a0135965060608a01356001600160401b0380821115614b6b57600080fd5b614b778d838e0161450b565b9098509650869150614b8b60808d01614553565b955060a08c01359150614b9d826146bf565b90935060c08b01359080821115614bb357600080fd5b50614bc08c828d0161450b565b915080935050809150509295985092959850929598565b600080600080600060808688031215614bef57600080fd5b614bf8866144f4565b9450614c06602087016144f4565b93506040860135925060608601356001600160401b03811115614c2857600080fd5b614c348882890161450b565b969995985093965092949392505050565b600080600060608486031215614c5a57600080fd5b6146a1846144f4565b6000806000806000806000806000806101008b8d031215614c8357600080fd5b614c8c8b6144f4565b995060208b01356001600160401b0380821115614ca857600080fd5b614cb48e838f0161450b565b909b509950899150614cc860408e01614553565b985060608d0135975060808d01359150614ce18261466c565b90955060a08c0135945060c08c01359080821115614cfe57600080fd5b50614d0b8d828e0161450b565b9150809450508092505060e08b013590509295989b9194979a5092959850565b60008060008060808587031215614d4157600080fd5b614d4a856144f4565b9350614d58602086016144f4565b92506040850135614d688161466c565b9396929550929360600135925050565b600181811c90821680614d8c57607f821691505b60208210810361493c57634e487b7160e01b600052602260045260246000fd5b8183823760009101908152919050565b60208082526026908201527f4c7a4170703a20696e76616c696420736f757263652073656e64696e6720636f6040820152651b9d1c9858dd60d21b606082015260800190565b600060208284031215614e1457600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b81810381811115610f1557610f15614e1b565b80820180821115610f1557610f15614e1b565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b61ffff84168152604060208201526000612439604083018486614e57565b6000808335601e19843603018112614eb557600080fd5b8301803591506001600160401b03821115614ecf57600080fd5b60200191503681900382131561454c57600080fd5b60008251614ef68184602087016149b5565b9190910192915050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b601f8211156126de576000816000526020600020601f850160051c81016020861015614f4f5750805b601f850160051c820191505b8181101561180957828155600101614f5b565b81516001600160401b03811115614f8757614f876147dc565b614f9b81614f958454614d78565b84614f26565b602080601f831160018114614fd05760008415614fb85750858301515b600019600386901b1c1916600185901b178555611809565b600085815260208120601f198616915b82811015614fff57888601518255948401946001909101908401614fe0565b508582101561501d5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b600061ffff8088168352808716602084015250846040830152608060608301526140bb608083018486614e57565b61ffff8916815260c06020820152600061507960c08301898b614e57565b6001600160401b038816604084015286606084015285608084015282810360a08401526150a7818587614e57565b9b9a5050505050505050505050565b6001600160401b038311156150cd576150cd6147dc565b6150e1836150db8354614d78565b83614f26565b6000601f84116001811461511557600085156150fd5750838201355b600019600387901b1c1916600186901b178355610f9d565b600083815260209020601f19861690835b828110156151465786850135825560209485019460019092019101615126565b50868210156151635760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b60006020828403121561518757600080fd5b81516001600160401b0381111561519d57600080fd5b8201601f810184136151ae57600080fd5b80516151bc6148a182614822565b8181528560208385010111156151d157600080fd5b612ef08260208301602086016149b5565b61ffff851681526080602082015260006151ff60808301866149d9565b6001600160401b038516604084015282810360608401526140bb81856149d9565b61ffff861681526001600160a01b038516602082015260a06040820181905260009061524e908301866149d9565b8415156060840152828103608084015261526881856149d9565b98975050505050505050565b6000806040838503121561528757600080fd5b505080516020909101519092909150565b61ffff861681526080602082015260006152b6608083018688614e57565b6001600160401b0394909416604083015250606001529392505050565b61ffff8616815260a0602082015260006152f060a08301876149d9565b6001600160401b0386166040840152828103606084015261531181866149d9565b9050828103608084015261526881856149d9565b634e487b7160e01b600052601260045260246000fd5b60008261534a5761534a615325565b500490565b60006020828403121561536157600080fd5b8151611d3b816146bf565b600061010061ffff8b16835280602084015261538a8184018b6149d9565b6001600160401b038a166040850152606084018990526001600160a01b038816608085015260a0840187905283810360c085015290506153ca81866149d9565b9150508260e08301529998505050505050505050565b6060815260006153f360608301866149d9565b6001600160401b039490941660208301525060400152919050565b60008261541d5761541d615325565b500690565b61ffff8716815260c06020820152600061543f60c08301886149d9565b828103604084015261545181886149d9565b6001600160a01b0387811660608601528616608085015283810360a0850152905061547c81856149d9565b9998505050505050505050565b60ff60f81b8760f81b16815285600182015260006001600160401b0360c01b808760c01b166021840152856029840152808560c01b1660498401525082516154d88160518501602087016149b5565b91909101605101979650505050505050565b8082028115828204841417610f1557610f15614e1b56fea264697066735822122078a20abcb22d7cb1fa2db0ea891c1e652ab0382a5180ce86b54f25c83dc77a1264736f6c63430008190033", "devdoc": { "author": "Venus", + "events": { + "Paused(address)": { + "details": "Emitted when the pause is triggered by `account`." + }, + "ReceiveFromChain(uint16,address,uint256)": { + "details": "Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain. `_nonce` is the inbound nonce." + }, + "SendToChain(uint16,address,bytes32,uint256)": { + "details": "Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`) `_nonce` is the outbound nonce" + }, + "Unpaused(address)": { + "details": "Emitted when the pause is lifted by `account`." + } + }, "kind": "dev", "methods": { "circulatingSupply()": { @@ -2245,7 +2259,7 @@ "storageLayout": { "storage": [ { - "astId": 5506, + "astId": 3647, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "_paused", "offset": 0, @@ -2253,7 +2267,7 @@ "type": "t_bool" }, { - "astId": 5383, + "astId": 3524, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "_owner", "offset": 1, @@ -2301,7 +2315,7 @@ "type": "t_mapping(t_uint16,t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bytes32)))" }, { - "astId": 3161, + "astId": 1618, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "creditedPackets", "offset": 0, @@ -2309,7 +2323,7 @@ "type": "t_mapping(t_uint16,t_mapping(t_bytes_memory_ptr,t_mapping(t_uint64,t_bool)))" }, { - "astId": 9369, + "astId": 5541, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "sendAndCallEnabled", "offset": 0, @@ -2317,15 +2331,15 @@ "type": "t_bool" }, { - "astId": 9373, + "astId": 5545, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "oracle", "offset": 1, "slot": "7", - "type": "t_contract(ResilientOracleInterface)8694" + "type": "t_contract(ResilientOracleInterface)4844" }, { - "astId": 9378, + "astId": 5550, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToMaxSingleTransactionLimit", "offset": 0, @@ -2333,7 +2347,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9383, + "astId": 5555, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToMaxDailyLimit", "offset": 0, @@ -2341,7 +2355,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9388, + "astId": 5560, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToLast24HourTransferred", "offset": 0, @@ -2349,7 +2363,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9393, + "astId": 5565, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToLast24HourWindowStart", "offset": 0, @@ -2357,7 +2371,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9398, + "astId": 5570, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToMaxSingleReceiveTransactionLimit", "offset": 0, @@ -2365,7 +2379,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9403, + "astId": 5575, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToMaxDailyReceiveLimit", "offset": 0, @@ -2373,7 +2387,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9408, + "astId": 5580, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToLast24HourReceived", "offset": 0, @@ -2381,7 +2395,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9413, + "astId": 5585, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "chainIdToLast24HourReceiveWindowStart", "offset": 0, @@ -2389,7 +2403,7 @@ "type": "t_mapping(t_uint16,t_uint256)" }, { - "astId": 9418, + "astId": 5590, "contract": "contracts/Bridge/XVSProxyOFTDest.sol:XVSProxyOFTDest", "label": "whitelist", "offset": 0, @@ -2423,7 +2437,7 @@ "label": "bytes", "numberOfBytes": "32" }, - "t_contract(ResilientOracleInterface)8694": { + "t_contract(ResilientOracleInterface)4844": { "encoding": "inplace", "label": "contract ResilientOracleInterface", "numberOfBytes": "20" diff --git a/deployments/arbitrumsepolia/solcInputs/15770bc3af16acbd95d8914f14cae6d7.json b/deployments/arbitrumsepolia/solcInputs/15770bc3af16acbd95d8914f14cae6d7.json new file mode 100644 index 0000000..04f14e3 --- /dev/null +++ b/deployments/arbitrumsepolia/solcInputs/15770bc3af16acbd95d8914f14cae6d7.json @@ -0,0 +1,151 @@ +{ + "language": "Solidity", + "sources": { + "@layerzerolabs/solidity-examples/contracts/libraries/BytesLib.sol": { + "content": "// SPDX-License-Identifier: Unlicense\n/*\n * @title Solidity Bytes Arrays Utils\n * @author Gonçalo Sá \n *\n * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.\n * The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.\n */\npragma solidity >=0.8.0 <0.9.0;\n\nlibrary BytesLib {\n function concat(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bytes memory) {\n bytes memory tempBytes;\n\n assembly {\n // Get a location of some free memory and store it in tempBytes as\n // Solidity does for memory variables.\n tempBytes := mload(0x40)\n\n // Store the length of the first bytes array at the beginning of\n // the memory for tempBytes.\n let length := mload(_preBytes)\n mstore(tempBytes, length)\n\n // Maintain a memory counter for the current write location in the\n // temp bytes array by adding the 32 bytes for the array length to\n // the starting location.\n let mc := add(tempBytes, 0x20)\n // Stop copying when the memory counter reaches the length of the\n // first bytes array.\n let end := add(mc, length)\n\n for {\n // Initialize a copy counter to the start of the _preBytes data,\n // 32 bytes into its memory.\n let cc := add(_preBytes, 0x20)\n } lt(mc, end) {\n // Increase both counters by 32 bytes each iteration.\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n // Write the _preBytes data into the tempBytes memory 32 bytes\n // at a time.\n mstore(mc, mload(cc))\n }\n\n // Add the length of _postBytes to the current length of tempBytes\n // and store it as the new length in the first 32 bytes of the\n // tempBytes memory.\n length := mload(_postBytes)\n mstore(tempBytes, add(length, mload(tempBytes)))\n\n // Move the memory counter back from a multiple of 0x20 to the\n // actual end of the _preBytes data.\n mc := end\n // Stop copying when the memory counter reaches the new combined\n // length of the arrays.\n end := add(mc, length)\n\n for {\n let cc := add(_postBytes, 0x20)\n } lt(mc, end) {\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n mstore(mc, mload(cc))\n }\n\n // Update the free-memory pointer by padding our last write location\n // to 32 bytes: add 31 bytes to the end of tempBytes to move to the\n // next 32 byte block, then round down to the nearest multiple of\n // 32. If the sum of the length of the two arrays is zero then add\n // one before rounding down to leave a blank 32 bytes (the length block with 0).\n mstore(\n 0x40,\n and(\n add(add(end, iszero(add(length, mload(_preBytes)))), 31),\n not(31) // Round down to the nearest 32 bytes.\n )\n )\n }\n\n return tempBytes;\n }\n\n function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {\n assembly {\n // Read the first 32 bytes of _preBytes storage, which is the length\n // of the array. (We don't need to use the offset into the slot\n // because arrays use the entire slot.)\n let fslot := sload(_preBytes.slot)\n // Arrays of 31 bytes or less have an even value in their slot,\n // while longer arrays have an odd value. The actual length is\n // the slot divided by two for odd values, and the lowest order\n // byte divided by two for even values.\n // If the slot is even, bitwise and the slot with 255 and divide by\n // two to get the length. If the slot is odd, bitwise and the slot\n // with -1 and divide by two.\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\n let mlength := mload(_postBytes)\n let newlength := add(slength, mlength)\n // slength can contain both the length and contents of the array\n // if length < 32 bytes so let's prepare for that\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\n switch add(lt(slength, 32), lt(newlength, 32))\n case 2 {\n // Since the new array still fits in the slot, we just need to\n // update the contents of the slot.\n // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length\n sstore(\n _preBytes.slot,\n // all the modifications to the slot are inside this\n // next block\n add(\n // we can just add to the slot contents because the\n // bytes we want to change are the LSBs\n fslot,\n add(\n mul(\n div(\n // load the bytes from memory\n mload(add(_postBytes, 0x20)),\n // zero all bytes to the right\n exp(0x100, sub(32, mlength))\n ),\n // and now shift left the number of bytes to\n // leave space for the length in the slot\n exp(0x100, sub(32, newlength))\n ),\n // increase length by the double of the memory\n // bytes length\n mul(mlength, 2)\n )\n )\n )\n }\n case 1 {\n // The stored value fits in the slot, but the combined value\n // will exceed it.\n // get the keccak hash to get the contents of the array\n mstore(0x0, _preBytes.slot)\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\n\n // save new length\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\n\n // The contents of the _postBytes array start 32 bytes into\n // the structure. Our first read should obtain the `submod`\n // bytes that can fit into the unused space in the last word\n // of the stored array. To get this, we read 32 bytes starting\n // from `submod`, so the data we read overlaps with the array\n // contents by `submod` bytes. Masking the lowest-order\n // `submod` bytes allows us to add that value directly to the\n // stored value.\n\n let submod := sub(32, slength)\n let mc := add(_postBytes, submod)\n let end := add(_postBytes, mlength)\n let mask := sub(exp(0x100, submod), 1)\n\n sstore(sc, add(and(fslot, 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00), and(mload(mc), mask)))\n\n for {\n mc := add(mc, 0x20)\n sc := add(sc, 1)\n } lt(mc, end) {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } {\n sstore(sc, mload(mc))\n }\n\n mask := exp(0x100, sub(mc, end))\n\n sstore(sc, mul(div(mload(mc), mask), mask))\n }\n default {\n // get the keccak hash to get the contents of the array\n mstore(0x0, _preBytes.slot)\n // Start copying to the last used word of the stored array.\n let sc := add(keccak256(0x0, 0x20), div(slength, 32))\n\n // save new length\n sstore(_preBytes.slot, add(mul(newlength, 2), 1))\n\n // Copy over the first `submod` bytes of the new data as in\n // case 1 above.\n let slengthmod := mod(slength, 32)\n let mlengthmod := mod(mlength, 32)\n let submod := sub(32, slengthmod)\n let mc := add(_postBytes, submod)\n let end := add(_postBytes, mlength)\n let mask := sub(exp(0x100, submod), 1)\n\n sstore(sc, add(sload(sc), and(mload(mc), mask)))\n\n for {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } lt(mc, end) {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } {\n sstore(sc, mload(mc))\n }\n\n mask := exp(0x100, sub(mc, end))\n\n sstore(sc, mul(div(mload(mc), mask), mask))\n }\n }\n }\n\n function slice(\n bytes memory _bytes,\n uint _start,\n uint _length\n ) internal pure returns (bytes memory) {\n require(_length + 31 >= _length, \"slice_overflow\");\n require(_bytes.length >= _start + _length, \"slice_outOfBounds\");\n\n bytes memory tempBytes;\n\n assembly {\n switch iszero(_length)\n case 0 {\n // Get a location of some free memory and store it in tempBytes as\n // Solidity does for memory variables.\n tempBytes := mload(0x40)\n\n // The first word of the slice result is potentially a partial\n // word read from the original array. To read it, we calculate\n // the length of that partial word and start copying that many\n // bytes into the array. The first word we copy will start with\n // data we don't care about, but the last `lengthmod` bytes will\n // land at the beginning of the contents of the new array. When\n // we're done copying, we overwrite the full first word with\n // the actual length of the slice.\n let lengthmod := and(_length, 31)\n\n // The multiplication in the next line is necessary\n // because when slicing multiples of 32 bytes (lengthmod == 0)\n // the following copy loop was copying the origin's length\n // and then ending prematurely not copying everything it should.\n let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))\n let end := add(mc, _length)\n\n for {\n // The multiplication in the next line has the same exact purpose\n // as the one above.\n let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)\n } lt(mc, end) {\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n mstore(mc, mload(cc))\n }\n\n mstore(tempBytes, _length)\n\n //update free-memory pointer\n //allocating the array padded to 32 bytes like the compiler does now\n mstore(0x40, and(add(mc, 31), not(31)))\n }\n //if we want a zero-length slice let's just return a zero-length array\n default {\n tempBytes := mload(0x40)\n //zero out the 32 bytes slice we are about to return\n //we need to do it because Solidity does not garbage collect\n mstore(tempBytes, 0)\n\n mstore(0x40, add(tempBytes, 0x20))\n }\n }\n\n return tempBytes;\n }\n\n function toAddress(bytes memory _bytes, uint _start) internal pure returns (address) {\n require(_bytes.length >= _start + 20, \"toAddress_outOfBounds\");\n address tempAddress;\n\n assembly {\n tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)\n }\n\n return tempAddress;\n }\n\n function toUint8(bytes memory _bytes, uint _start) internal pure returns (uint8) {\n require(_bytes.length >= _start + 1, \"toUint8_outOfBounds\");\n uint8 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x1), _start))\n }\n\n return tempUint;\n }\n\n function toUint16(bytes memory _bytes, uint _start) internal pure returns (uint16) {\n require(_bytes.length >= _start + 2, \"toUint16_outOfBounds\");\n uint16 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x2), _start))\n }\n\n return tempUint;\n }\n\n function toUint32(bytes memory _bytes, uint _start) internal pure returns (uint32) {\n require(_bytes.length >= _start + 4, \"toUint32_outOfBounds\");\n uint32 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x4), _start))\n }\n\n return tempUint;\n }\n\n function toUint64(bytes memory _bytes, uint _start) internal pure returns (uint64) {\n require(_bytes.length >= _start + 8, \"toUint64_outOfBounds\");\n uint64 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x8), _start))\n }\n\n return tempUint;\n }\n\n function toUint96(bytes memory _bytes, uint _start) internal pure returns (uint96) {\n require(_bytes.length >= _start + 12, \"toUint96_outOfBounds\");\n uint96 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0xc), _start))\n }\n\n return tempUint;\n }\n\n function toUint128(bytes memory _bytes, uint _start) internal pure returns (uint128) {\n require(_bytes.length >= _start + 16, \"toUint128_outOfBounds\");\n uint128 tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x10), _start))\n }\n\n return tempUint;\n }\n\n function toUint256(bytes memory _bytes, uint _start) internal pure returns (uint) {\n require(_bytes.length >= _start + 32, \"toUint256_outOfBounds\");\n uint tempUint;\n\n assembly {\n tempUint := mload(add(add(_bytes, 0x20), _start))\n }\n\n return tempUint;\n }\n\n function toBytes32(bytes memory _bytes, uint _start) internal pure returns (bytes32) {\n require(_bytes.length >= _start + 32, \"toBytes32_outOfBounds\");\n bytes32 tempBytes32;\n\n assembly {\n tempBytes32 := mload(add(add(_bytes, 0x20), _start))\n }\n\n return tempBytes32;\n }\n\n function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {\n bool success = true;\n\n assembly {\n let length := mload(_preBytes)\n\n // if lengths don't match the arrays are not equal\n switch eq(length, mload(_postBytes))\n case 1 {\n // cb is a circuit breaker in the for loop since there's\n // no said feature for inline assembly loops\n // cb = 1 - don't breaker\n // cb = 0 - break\n let cb := 1\n\n let mc := add(_preBytes, 0x20)\n let end := add(mc, length)\n\n for {\n let cc := add(_postBytes, 0x20)\n // the next line is the loop condition:\n // while(uint256(mc < end) + cb == 2)\n } eq(add(lt(mc, end), cb), 2) {\n mc := add(mc, 0x20)\n cc := add(cc, 0x20)\n } {\n // if any of these checks fails then arrays are not equal\n if iszero(eq(mload(mc), mload(cc))) {\n // unsuccess:\n success := 0\n cb := 0\n }\n }\n }\n default {\n // unsuccess:\n success := 0\n }\n }\n\n return success;\n }\n\n function equalStorage(bytes storage _preBytes, bytes memory _postBytes) internal view returns (bool) {\n bool success = true;\n\n assembly {\n // we know _preBytes_offset is 0\n let fslot := sload(_preBytes.slot)\n // Decode the length of the stored array like in concatStorage().\n let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)\n let mlength := mload(_postBytes)\n\n // if lengths don't match the arrays are not equal\n switch eq(slength, mlength)\n case 1 {\n // slength can contain both the length and contents of the array\n // if length < 32 bytes so let's prepare for that\n // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage\n if iszero(iszero(slength)) {\n switch lt(slength, 32)\n case 1 {\n // blank the last byte which is the length\n fslot := mul(div(fslot, 0x100), 0x100)\n\n if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {\n // unsuccess:\n success := 0\n }\n }\n default {\n // cb is a circuit breaker in the for loop since there's\n // no said feature for inline assembly loops\n // cb = 1 - don't breaker\n // cb = 0 - break\n let cb := 1\n\n // get the keccak hash to get the contents of the array\n mstore(0x0, _preBytes.slot)\n let sc := keccak256(0x0, 0x20)\n\n let mc := add(_postBytes, 0x20)\n let end := add(mc, mlength)\n\n // the next line is the loop condition:\n // while(uint256(mc < end) + cb == 2)\n for {\n\n } eq(add(lt(mc, end), cb), 2) {\n sc := add(sc, 1)\n mc := add(mc, 0x20)\n } {\n if iszero(eq(sload(sc), mload(mc))) {\n // unsuccess:\n success := 0\n cb := 0\n }\n }\n }\n }\n }\n default {\n // unsuccess:\n success := 0\n }\n }\n\n return success;\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/libraries/ExcessivelySafeCall.sol": { + "content": "// SPDX-License-Identifier: MIT OR Apache-2.0\npragma solidity >=0.7.6;\n\nlibrary ExcessivelySafeCall {\n uint constant LOW_28_MASK = 0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;\n\n /// @notice Use when you _really_ really _really_ don't trust the called\n /// contract. This prevents the called contract from causing reversion of\n /// the caller in as many ways as we can.\n /// @dev The main difference between this and a solidity low-level call is\n /// that we limit the number of bytes that the callee can cause to be\n /// copied to caller memory. This prevents stupid things like malicious\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\n /// to memory.\n /// @param _target The address to call\n /// @param _gas The amount of gas to forward to the remote contract\n /// @param _maxCopy The maximum number of bytes of returndata to copy\n /// to memory.\n /// @param _calldata The data to send to the remote contract\n /// @return success and returndata, as `.call()`. Returndata is capped to\n /// `_maxCopy` bytes.\n function excessivelySafeCall(\n address _target,\n uint _gas,\n uint16 _maxCopy,\n bytes memory _calldata\n ) internal returns (bool, bytes memory) {\n // set up for assembly call\n uint _toCopy;\n bool _success;\n bytes memory _returnData = new bytes(_maxCopy);\n // dispatch message to recipient\n // by assembly calling \"handle\" function\n // we call via assembly to avoid memcopying a very large returndata\n // returned by a malicious contract\n assembly {\n _success := call(\n _gas, // gas\n _target, // recipient\n 0, // ether value\n add(_calldata, 0x20), // inloc\n mload(_calldata), // inlen\n 0, // outloc\n 0 // outlen\n )\n // limit our copy to 256 bytes\n _toCopy := returndatasize()\n if gt(_toCopy, _maxCopy) {\n _toCopy := _maxCopy\n }\n // Store the length of the copied bytes\n mstore(_returnData, _toCopy)\n // copy the bytes from returndata[0:_toCopy]\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\n }\n return (_success, _returnData);\n }\n\n /// @notice Use when you _really_ really _really_ don't trust the called\n /// contract. This prevents the called contract from causing reversion of\n /// the caller in as many ways as we can.\n /// @dev The main difference between this and a solidity low-level call is\n /// that we limit the number of bytes that the callee can cause to be\n /// copied to caller memory. This prevents stupid things like malicious\n /// contracts returning 10,000,000 bytes causing a local OOG when copying\n /// to memory.\n /// @param _target The address to call\n /// @param _gas The amount of gas to forward to the remote contract\n /// @param _maxCopy The maximum number of bytes of returndata to copy\n /// to memory.\n /// @param _calldata The data to send to the remote contract\n /// @return success and returndata, as `.call()`. Returndata is capped to\n /// `_maxCopy` bytes.\n function excessivelySafeStaticCall(\n address _target,\n uint _gas,\n uint16 _maxCopy,\n bytes memory _calldata\n ) internal view returns (bool, bytes memory) {\n // set up for assembly call\n uint _toCopy;\n bool _success;\n bytes memory _returnData = new bytes(_maxCopy);\n // dispatch message to recipient\n // by assembly calling \"handle\" function\n // we call via assembly to avoid memcopying a very large returndata\n // returned by a malicious contract\n assembly {\n _success := staticcall(\n _gas, // gas\n _target, // recipient\n add(_calldata, 0x20), // inloc\n mload(_calldata), // inlen\n 0, // outloc\n 0 // outlen\n )\n // limit our copy to 256 bytes\n _toCopy := returndatasize()\n if gt(_toCopy, _maxCopy) {\n _toCopy := _maxCopy\n }\n // Store the length of the copied bytes\n mstore(_returnData, _toCopy)\n // copy the bytes from returndata[0:_toCopy]\n returndatacopy(add(_returnData, 0x20), 0, _toCopy)\n }\n return (_success, _returnData);\n }\n\n /**\n * @notice Swaps function selectors in encoded contract calls\n * @dev Allows reuse of encoded calldata for functions with identical\n * argument types but different names. It simply swaps out the first 4 bytes\n * for the new selector. This function modifies memory in place, and should\n * only be used with caution.\n * @param _newSelector The new 4-byte selector\n * @param _buf The encoded contract args\n */\n function swapSelector(bytes4 _newSelector, bytes memory _buf) internal pure {\n require(_buf.length >= 4);\n uint _mask = LOW_28_MASK;\n assembly {\n // load the first word of\n let _word := mload(add(_buf, 0x20))\n // mask out the top 4 bytes\n // /x\n _word := and(_word, _mask)\n _word := or(_newSelector, _word)\n mstore(add(_buf, 0x20), _word)\n }\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroEndpoint.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\nimport \"./ILayerZeroUserApplicationConfig.sol\";\n\ninterface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {\n // @notice send a LayerZero message to the specified address at a LayerZero endpoint.\n // @param _dstChainId - the destination chain identifier\n // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains\n // @param _payload - a custom bytes payload to send to the destination contract\n // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address\n // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction\n // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination\n function send(\n uint16 _dstChainId,\n bytes calldata _destination,\n bytes calldata _payload,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes calldata _adapterParams\n ) external payable;\n\n // @notice used by the messaging library to publish verified payload\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source contract (as bytes) at the source chain\n // @param _dstAddress - the address on destination chain\n // @param _nonce - the unbound message ordering nonce\n // @param _gasLimit - the gas limit for external contract execution\n // @param _payload - verified payload to send to the destination contract\n function receivePayload(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n address _dstAddress,\n uint64 _nonce,\n uint _gasLimit,\n bytes calldata _payload\n ) external;\n\n // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source chain contract address\n function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);\n\n // @notice get the outboundNonce from this source chain which, consequently, is always an EVM\n // @param _srcAddress - the source chain contract address\n function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);\n\n // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery\n // @param _dstChainId - the destination chain identifier\n // @param _userApplication - the user app address on this EVM chain\n // @param _payload - the custom message to send over LayerZero\n // @param _payInZRO - if false, user app pays the protocol fee in native token\n // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain\n function estimateFees(\n uint16 _dstChainId,\n address _userApplication,\n bytes calldata _payload,\n bool _payInZRO,\n bytes calldata _adapterParam\n ) external view returns (uint nativeFee, uint zroFee);\n\n // @notice get this Endpoint's immutable source identifier\n function getChainId() external view returns (uint16);\n\n // @notice the interface to retry failed message on this Endpoint destination\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source chain contract address\n // @param _payload - the payload to be retried\n function retryPayload(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n bytes calldata _payload\n ) external;\n\n // @notice query if any STORED payload (message blocking) at the endpoint.\n // @param _srcChainId - the source chain identifier\n // @param _srcAddress - the source chain contract address\n function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);\n\n // @notice query if the _libraryAddress is valid for sending msgs.\n // @param _userApplication - the user app address on this EVM chain\n function getSendLibraryAddress(address _userApplication) external view returns (address);\n\n // @notice query if the _libraryAddress is valid for receiving msgs.\n // @param _userApplication - the user app address on this EVM chain\n function getReceiveLibraryAddress(address _userApplication) external view returns (address);\n\n // @notice query if the non-reentrancy guard for send() is on\n // @return true if the guard is on. false otherwise\n function isSendingPayload() external view returns (bool);\n\n // @notice query if the non-reentrancy guard for receive() is on\n // @return true if the guard is on. false otherwise\n function isReceivingPayload() external view returns (bool);\n\n // @notice get the configuration of the LayerZero messaging library of the specified version\n // @param _version - messaging library version\n // @param _chainId - the chainId for the pending config change\n // @param _userApplication - the contract address of the user application\n // @param _configType - type of configuration. every messaging library has its own convention.\n function getConfig(\n uint16 _version,\n uint16 _chainId,\n address _userApplication,\n uint _configType\n ) external view returns (bytes memory);\n\n // @notice get the send() LayerZero messaging library version\n // @param _userApplication - the contract address of the user application\n function getSendVersion(address _userApplication) external view returns (uint16);\n\n // @notice get the lzReceive() LayerZero messaging library version\n // @param _userApplication - the contract address of the user application\n function getReceiveVersion(address _userApplication) external view returns (uint16);\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroReceiver.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\ninterface ILayerZeroReceiver {\n // @notice LayerZero endpoint will invoke this function to deliver the message on the destination\n // @param _srcChainId - the source endpoint identifier\n // @param _srcAddress - the source sending contract address from the source chain\n // @param _nonce - the ordered message nonce\n // @param _payload - the signed payload is the UA bytes has encoded to be sent\n function lzReceive(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) external;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/interfaces/ILayerZeroUserApplicationConfig.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\ninterface ILayerZeroUserApplicationConfig {\n // @notice set the configuration of the LayerZero messaging library of the specified version\n // @param _version - messaging library version\n // @param _chainId - the chainId for the pending config change\n // @param _configType - type of configuration. every messaging library has its own convention.\n // @param _config - configuration in the bytes. can encode arbitrary content.\n function setConfig(\n uint16 _version,\n uint16 _chainId,\n uint _configType,\n bytes calldata _config\n ) external;\n\n // @notice set the send() LayerZero messaging library version to _version\n // @param _version - new messaging library version\n function setSendVersion(uint16 _version) external;\n\n // @notice set the lzReceive() LayerZero messaging library version to _version\n // @param _version - new messaging library version\n function setReceiveVersion(uint16 _version) external;\n\n // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload\n // @param _srcChainId - the chainId of the source chain\n // @param _srcAddress - the contract address of the source contract at the source chain\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/LzApp.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"./interfaces/ILayerZeroReceiver.sol\";\nimport \"./interfaces/ILayerZeroUserApplicationConfig.sol\";\nimport \"./interfaces/ILayerZeroEndpoint.sol\";\nimport \"../libraries/BytesLib.sol\";\n\n/*\n * a generic LzReceiver implementation\n */\nabstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {\n using BytesLib for bytes;\n\n // ua can not send payload larger than this by default, but it can be changed by the ua owner\n uint public constant DEFAULT_PAYLOAD_SIZE_LIMIT = 10000;\n\n ILayerZeroEndpoint public immutable lzEndpoint;\n mapping(uint16 => bytes) public trustedRemoteLookup;\n mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;\n mapping(uint16 => uint) public payloadSizeLimitLookup;\n address public precrime;\n\n event SetPrecrime(address precrime);\n event SetTrustedRemote(uint16 _remoteChainId, bytes _path);\n event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);\n event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);\n\n constructor(address _endpoint) {\n lzEndpoint = ILayerZeroEndpoint(_endpoint);\n }\n\n function lzReceive(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public virtual override {\n // lzReceive must be called by the endpoint for security\n require(_msgSender() == address(lzEndpoint), \"LzApp: invalid endpoint caller\");\n\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\n // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\n require(\n _srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote),\n \"LzApp: invalid source sending contract\"\n );\n\n _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging\n function _blockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual;\n\n function _lzSend(\n uint16 _dstChainId,\n bytes memory _payload,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams,\n uint _nativeFee\n ) internal virtual {\n bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];\n require(trustedRemote.length != 0, \"LzApp: destination chain is not a trusted source\");\n _checkPayloadSize(_dstChainId, _payload.length);\n lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);\n }\n\n function _checkGasLimit(\n uint16 _dstChainId,\n uint16 _type,\n bytes memory _adapterParams,\n uint _extraGas\n ) internal view virtual {\n uint providedGasLimit = _getGasLimit(_adapterParams);\n uint minGasLimit = minDstGasLookup[_dstChainId][_type];\n require(minGasLimit > 0, \"LzApp: minGasLimit not set\");\n require(providedGasLimit >= minGasLimit + _extraGas, \"LzApp: gas limit is too low\");\n }\n\n function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {\n require(_adapterParams.length >= 34, \"LzApp: invalid adapterParams\");\n assembly {\n gasLimit := mload(add(_adapterParams, 34))\n }\n }\n\n function _checkPayloadSize(uint16 _dstChainId, uint _payloadSize) internal view virtual {\n uint payloadSizeLimit = payloadSizeLimitLookup[_dstChainId];\n if (payloadSizeLimit == 0) {\n // use default if not set\n payloadSizeLimit = DEFAULT_PAYLOAD_SIZE_LIMIT;\n }\n require(_payloadSize <= payloadSizeLimit, \"LzApp: payload size is too large\");\n }\n\n //---------------------------UserApplication config----------------------------------------\n function getConfig(\n uint16 _version,\n uint16 _chainId,\n address,\n uint _configType\n ) external view returns (bytes memory) {\n return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);\n }\n\n // generic config for LayerZero user Application\n function setConfig(\n uint16 _version,\n uint16 _chainId,\n uint _configType,\n bytes calldata _config\n ) external override onlyOwner {\n lzEndpoint.setConfig(_version, _chainId, _configType, _config);\n }\n\n function setSendVersion(uint16 _version) external override onlyOwner {\n lzEndpoint.setSendVersion(_version);\n }\n\n function setReceiveVersion(uint16 _version) external override onlyOwner {\n lzEndpoint.setReceiveVersion(_version);\n }\n\n function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {\n lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);\n }\n\n // _path = abi.encodePacked(remoteAddress, localAddress)\n // this function set the trusted path for the cross-chain communication\n function setTrustedRemote(uint16 _remoteChainId, bytes calldata _path) external onlyOwner {\n trustedRemoteLookup[_remoteChainId] = _path;\n emit SetTrustedRemote(_remoteChainId, _path);\n }\n\n function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {\n trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));\n emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);\n }\n\n function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {\n bytes memory path = trustedRemoteLookup[_remoteChainId];\n require(path.length != 0, \"LzApp: no trusted path record\");\n return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)\n }\n\n function setPrecrime(address _precrime) external onlyOwner {\n precrime = _precrime;\n emit SetPrecrime(_precrime);\n }\n\n function setMinDstGas(\n uint16 _dstChainId,\n uint16 _packetType,\n uint _minGas\n ) external onlyOwner {\n minDstGasLookup[_dstChainId][_packetType] = _minGas;\n emit SetMinDstGas(_dstChainId, _packetType, _minGas);\n }\n\n // if the size is 0, it means default size limit\n function setPayloadSizeLimit(uint16 _dstChainId, uint _size) external onlyOwner {\n payloadSizeLimitLookup[_dstChainId] = _size;\n }\n\n //--------------------------- VIEW FUNCTION ----------------------------------------\n function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {\n bytes memory trustedSource = trustedRemoteLookup[_srcChainId];\n return keccak256(trustedSource) == keccak256(_srcAddress);\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/lzApp/NonblockingLzApp.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"./LzApp.sol\";\nimport \"../libraries/ExcessivelySafeCall.sol\";\n\n/*\n * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel\n * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking\n * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)\n */\nabstract contract NonblockingLzApp is LzApp {\n using ExcessivelySafeCall for address;\n\n constructor(address _endpoint) LzApp(_endpoint) {}\n\n mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;\n\n event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);\n event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);\n\n // overriding the virtual function in LzReceiver\n function _blockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual override {\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\n gasleft(),\n 150,\n abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload)\n );\n // try-catch all errors/exceptions\n if (!success) {\n _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);\n }\n }\n\n function _storeFailedMessage(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload,\n bytes memory _reason\n ) internal virtual {\n failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);\n emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);\n }\n\n function nonblockingLzReceive(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public virtual {\n // only internal transaction\n require(_msgSender() == address(this), \"NonblockingLzApp: caller must be LzApp\");\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n //@notice override this function\n function _nonblockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual;\n\n function retryMessage(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public payable virtual {\n // assert there is message to retry\n bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];\n require(payloadHash != bytes32(0), \"NonblockingLzApp: no stored message\");\n require(keccak256(_payload) == payloadHash, \"NonblockingLzApp: invalid payload\");\n // clear the stored message\n failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);\n // execute the message. revert if it fails again\n _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);\n emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);\n }\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"./OFTCoreV2.sol\";\nimport \"./interfaces/IOFTV2.sol\";\nimport \"@openzeppelin/contracts/utils/introspection/ERC165.sol\";\n\nabstract contract BaseOFTV2 is OFTCoreV2, ERC165, IOFTV2 {\n constructor(uint8 _sharedDecimals, address _lzEndpoint) OFTCoreV2(_sharedDecimals, _lzEndpoint) {}\n\n /************************************************************************\n * public functions\n ************************************************************************/\n function sendFrom(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n LzCallParams calldata _callParams\n ) public payable virtual override {\n _send(_from, _dstChainId, _toAddress, _amount, _callParams.refundAddress, _callParams.zroPaymentAddress, _callParams.adapterParams);\n }\n\n function sendAndCall(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes calldata _payload,\n uint64 _dstGasForCall,\n LzCallParams calldata _callParams\n ) public payable virtual override {\n _sendAndCall(\n _from,\n _dstChainId,\n _toAddress,\n _amount,\n _payload,\n _dstGasForCall,\n _callParams.refundAddress,\n _callParams.zroPaymentAddress,\n _callParams.adapterParams\n );\n }\n\n /************************************************************************\n * public view functions\n ************************************************************************/\n function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {\n return interfaceId == type(IOFTV2).interfaceId || super.supportsInterface(interfaceId);\n }\n\n function estimateSendFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bool _useZro,\n bytes calldata _adapterParams\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\n return _estimateSendFee(_dstChainId, _toAddress, _amount, _useZro, _adapterParams);\n }\n\n function estimateSendAndCallFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes calldata _payload,\n uint64 _dstGasForCall,\n bool _useZro,\n bytes calldata _adapterParams\n ) public view virtual override returns (uint nativeFee, uint zroFee) {\n return _estimateSendAndCallFee(_dstChainId, _toAddress, _amount, _payload, _dstGasForCall, _useZro, _adapterParams);\n }\n\n function circulatingSupply() public view virtual override returns (uint);\n\n function token() public view virtual override returns (address);\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/ICommonOFT.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\nimport \"@openzeppelin/contracts/utils/introspection/IERC165.sol\";\n\n/**\n * @dev Interface of the IOFT core standard\n */\ninterface ICommonOFT is IERC165 {\n\n struct LzCallParams {\n address payable refundAddress;\n address zroPaymentAddress;\n bytes adapterParams;\n }\n\n /**\n * @dev estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`)\n * _dstChainId - L0 defined chain id to send tokens too\n * _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain\n * _amount - amount of the tokens to transfer\n * _useZro - indicates to use zro to pay L0 fees\n * _adapterParam - flexible bytes array to indicate messaging adapter services in L0\n */\n function estimateSendFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\n\n function estimateSendAndCallFee(uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);\n\n /**\n * @dev returns the circulating amount of tokens on current chain\n */\n function circulatingSupply() external view returns (uint);\n\n /**\n * @dev returns the address of the ERC20 token\n */\n function token() external view returns (address);\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTReceiverV2.sol": { + "content": "// SPDX-License-Identifier: BUSL-1.1\n\npragma solidity >=0.5.0;\n\ninterface IOFTReceiverV2 {\n /**\n * @dev Called by the OFT contract when tokens are received from source chain.\n * @param _srcChainId The chain id of the source chain.\n * @param _srcAddress The address of the OFT token contract on the source chain.\n * @param _nonce The nonce of the transaction on the source chain.\n * @param _from The address of the account who calls the sendAndCall() on the source chain.\n * @param _amount The amount of tokens to transfer.\n * @param _payload Additional data with no specified format.\n */\n function onOFTReceived(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes32 _from, uint _amount, bytes calldata _payload) external;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/interfaces/IOFTV2.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity >=0.5.0;\n\nimport \"./ICommonOFT.sol\";\n\n/**\n * @dev Interface of the IOFT core standard\n */\ninterface IOFTV2 is ICommonOFT {\n\n /**\n * @dev send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from`\n * `_from` the owner of token\n * `_dstChainId` the destination chain identifier\n * `_toAddress` can be any size depending on the `dstChainId`.\n * `_amount` the quantity of tokens in wei\n * `_refundAddress` the address LayerZero refunds if too much message fee is sent\n * `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token)\n * `_adapterParams` is a flexible bytes array to indicate messaging adapter services\n */\n function sendFrom(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, LzCallParams calldata _callParams) external payable;\n\n function sendAndCall(address _from, uint16 _dstChainId, bytes32 _toAddress, uint _amount, bytes calldata _payload, uint64 _dstGasForCall, LzCallParams calldata _callParams) external payable;\n}\n" + }, + "@layerzerolabs/solidity-examples/contracts/token/oft/v2/OFTCoreV2.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"../../../lzApp/NonblockingLzApp.sol\";\nimport \"../../../libraries/ExcessivelySafeCall.sol\";\nimport \"./interfaces/ICommonOFT.sol\";\nimport \"./interfaces/IOFTReceiverV2.sol\";\n\nabstract contract OFTCoreV2 is NonblockingLzApp {\n using BytesLib for bytes;\n using ExcessivelySafeCall for address;\n\n uint public constant NO_EXTRA_GAS = 0;\n\n // packet type\n uint8 public constant PT_SEND = 0;\n uint8 public constant PT_SEND_AND_CALL = 1;\n\n uint8 public immutable sharedDecimals;\n\n mapping(uint16 => mapping(bytes => mapping(uint64 => bool))) public creditedPackets;\n\n /**\n * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)\n * `_nonce` is the outbound nonce\n */\n event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes32 indexed _toAddress, uint _amount);\n\n /**\n * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.\n * `_nonce` is the inbound nonce.\n */\n event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);\n\n event CallOFTReceivedSuccess(uint16 indexed _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _hash);\n\n event NonContractAddress(address _address);\n\n // _sharedDecimals should be the minimum decimals on all chains\n constructor(uint8 _sharedDecimals, address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {\n sharedDecimals = _sharedDecimals;\n }\n\n /************************************************************************\n * public functions\n ************************************************************************/\n function callOnOFTReceived(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes32 _from,\n address _to,\n uint _amount,\n bytes calldata _payload,\n uint _gasForCall\n ) public virtual {\n require(_msgSender() == address(this), \"OFTCore: caller must be OFTCore\");\n\n // send\n _amount = _transferFrom(address(this), _to, _amount);\n emit ReceiveFromChain(_srcChainId, _to, _amount);\n\n // call\n IOFTReceiverV2(_to).onOFTReceived{gas: _gasForCall}(_srcChainId, _srcAddress, _nonce, _from, _amount, _payload);\n }\n\n /************************************************************************\n * internal functions\n ************************************************************************/\n function _estimateSendFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bool _useZro,\n bytes memory _adapterParams\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\n // mock the payload for sendFrom()\n bytes memory payload = _encodeSendPayload(_toAddress, _ld2sd(_amount));\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\n }\n\n function _estimateSendAndCallFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes memory _payload,\n uint64 _dstGasForCall,\n bool _useZro,\n bytes memory _adapterParams\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\n // mock the payload for sendAndCall()\n bytes memory payload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(_amount), _payload, _dstGasForCall);\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\n }\n\n function _nonblockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual override {\n uint8 packetType = _payload.toUint8(0);\n\n if (packetType == PT_SEND) {\n _sendAck(_srcChainId, _srcAddress, _nonce, _payload);\n } else if (packetType == PT_SEND_AND_CALL) {\n _sendAndCallAck(_srcChainId, _srcAddress, _nonce, _payload);\n } else {\n revert(\"OFTCore: unknown packet type\");\n }\n }\n\n function _send(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) internal virtual returns (uint amount) {\n _checkGasLimit(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);\n\n (amount, ) = _removeDust(_amount);\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount); // amount returned should not have dust\n require(amount > 0, \"OFTCore: amount too small\");\n\n bytes memory lzPayload = _encodeSendPayload(_toAddress, _ld2sd(amount));\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\n\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\n }\n\n function _sendAck(\n uint16 _srcChainId,\n bytes memory,\n uint64,\n bytes memory _payload\n ) internal virtual {\n (address to, uint64 amountSD) = _decodeSendPayload(_payload);\n if (to == address(0)) {\n to = address(0xdead);\n }\n\n uint amount = _sd2ld(amountSD);\n amount = _creditTo(_srcChainId, to, amount);\n\n emit ReceiveFromChain(_srcChainId, to, amount);\n }\n\n function _sendAndCall(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes memory _payload,\n uint64 _dstGasForCall,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) internal virtual returns (uint amount) {\n _checkGasLimit(_dstChainId, PT_SEND_AND_CALL, _adapterParams, _dstGasForCall);\n\n (amount, ) = _removeDust(_amount);\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount);\n require(amount > 0, \"OFTCore: amount too small\");\n\n // encode the msg.sender into the payload instead of _from\n bytes memory lzPayload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(amount), _payload, _dstGasForCall);\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\n\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\n }\n\n function _sendAndCallAck(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual {\n (bytes32 from, address to, uint64 amountSD, bytes memory payloadForCall, uint64 gasForCall) = _decodeSendAndCallPayload(_payload);\n\n bool credited = creditedPackets[_srcChainId][_srcAddress][_nonce];\n uint amount = _sd2ld(amountSD);\n\n // credit to this contract first, and then transfer to receiver only if callOnOFTReceived() succeeds\n if (!credited) {\n amount = _creditTo(_srcChainId, address(this), amount);\n creditedPackets[_srcChainId][_srcAddress][_nonce] = true;\n }\n\n if (!_isContract(to)) {\n emit NonContractAddress(to);\n return;\n }\n\n // workaround for stack too deep\n uint16 srcChainId = _srcChainId;\n bytes memory srcAddress = _srcAddress;\n uint64 nonce = _nonce;\n bytes memory payload = _payload;\n bytes32 from_ = from;\n address to_ = to;\n uint amount_ = amount;\n bytes memory payloadForCall_ = payloadForCall;\n\n // no gas limit for the call if retry\n uint gas = credited ? gasleft() : gasForCall;\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\n gasleft(),\n 150,\n abi.encodeWithSelector(this.callOnOFTReceived.selector, srcChainId, srcAddress, nonce, from_, to_, amount_, payloadForCall_, gas)\n );\n\n if (success) {\n bytes32 hash = keccak256(payload);\n emit CallOFTReceivedSuccess(srcChainId, srcAddress, nonce, hash);\n } else {\n // store the failed message into the nonblockingLzApp\n _storeFailedMessage(srcChainId, srcAddress, nonce, payload, reason);\n }\n }\n\n function _isContract(address _account) internal view returns (bool) {\n return _account.code.length > 0;\n }\n\n function _ld2sd(uint _amount) internal view virtual returns (uint64) {\n uint amountSD = _amount / _ld2sdRate();\n require(amountSD <= type(uint64).max, \"OFTCore: amountSD overflow\");\n return uint64(amountSD);\n }\n\n function _sd2ld(uint64 _amountSD) internal view virtual returns (uint) {\n return _amountSD * _ld2sdRate();\n }\n\n function _removeDust(uint _amount) internal view virtual returns (uint amountAfter, uint dust) {\n dust = _amount % _ld2sdRate();\n amountAfter = _amount - dust;\n }\n\n function _encodeSendPayload(bytes32 _toAddress, uint64 _amountSD) internal view virtual returns (bytes memory) {\n return abi.encodePacked(PT_SEND, _toAddress, _amountSD);\n }\n\n function _decodeSendPayload(bytes memory _payload) internal view virtual returns (address to, uint64 amountSD) {\n require(_payload.toUint8(0) == PT_SEND && _payload.length == 41, \"OFTCore: invalid payload\");\n\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\n amountSD = _payload.toUint64(33);\n }\n\n function _encodeSendAndCallPayload(\n address _from,\n bytes32 _toAddress,\n uint64 _amountSD,\n bytes memory _payload,\n uint64 _dstGasForCall\n ) internal view virtual returns (bytes memory) {\n return abi.encodePacked(PT_SEND_AND_CALL, _toAddress, _amountSD, _addressToBytes32(_from), _dstGasForCall, _payload);\n }\n\n function _decodeSendAndCallPayload(bytes memory _payload)\n internal\n view\n virtual\n returns (\n bytes32 from,\n address to,\n uint64 amountSD,\n bytes memory payload,\n uint64 dstGasForCall\n )\n {\n require(_payload.toUint8(0) == PT_SEND_AND_CALL, \"OFTCore: invalid payload\");\n\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\n amountSD = _payload.toUint64(33);\n from = _payload.toBytes32(41);\n dstGasForCall = _payload.toUint64(73);\n payload = _payload.slice(81, _payload.length - 81);\n }\n\n function _addressToBytes32(address _address) internal pure virtual returns (bytes32) {\n return bytes32(uint(uint160(_address)));\n }\n\n function _debitFrom(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount\n ) internal virtual returns (uint);\n\n function _creditTo(\n uint16 _srcChainId,\n address _toAddress,\n uint _amount\n ) internal virtual returns (uint);\n\n function _transferFrom(\n address _from,\n address _to,\n uint _amount\n ) internal virtual returns (uint);\n\n function _ld2sdRate() internal view virtual returns (uint);\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./OwnableUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership} and {acceptOwnership}.\n *\n * This module is used through inheritance. It will make available all functions\n * from parent (Ownable).\n */\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\n function __Ownable2Step_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable2Step_init_unchained() internal onlyInitializing {\n }\n address private _pendingOwner;\n\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Returns the address of the pending owner.\n */\n function pendingOwner() public view virtual returns (address) {\n return _pendingOwner;\n }\n\n /**\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual override onlyOwner {\n _pendingOwner = newOwner;\n emit OwnershipTransferStarted(owner(), newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual override {\n delete _pendingOwner;\n super._transferOwnership(newOwner);\n }\n\n /**\n * @dev The new owner accepts the ownership transfer.\n */\n function acceptOwnership() public virtual {\n address sender = _msgSender();\n require(pendingOwner() == sender, \"Ownable2Step: caller is not the new owner\");\n _transferOwnership(sender);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n function __Ownable_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable_init_unchained() internal onlyInitializing {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract ContextUpgradeable is Initializable {\n function __Context_init() internal onlyInitializing {\n }\n\n function __Context_init_unchained() internal onlyInitializing {\n }\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n" + }, + "@openzeppelin/contracts/access/IAccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev External interface of AccessControl declared to support ERC165 detection.\n */\ninterface IAccessControl {\n /**\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\n *\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\n * {RoleAdminChanged} not being emitted signaling this.\n *\n * _Available since v3.1._\n */\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\n\n /**\n * @dev Emitted when `account` is granted `role`.\n *\n * `sender` is the account that originated the contract call, an admin role\n * bearer except when using {AccessControl-_setupRole}.\n */\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Emitted when `account` is revoked `role`.\n *\n * `sender` is the account that originated the contract call:\n * - if using `revokeRole`, it is the admin role bearer\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\n */\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) external view returns (bool);\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function grantRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function revokeRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been granted `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n */\n function renounceRole(bytes32 role, address account) external;\n}\n" + }, + "@openzeppelin/contracts/access/Ownable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n constructor() {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n}\n" + }, + "@openzeppelin/contracts/security/Pausable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which allows children to implement an emergency stop\n * mechanism that can be triggered by an authorized account.\n *\n * This module is used through inheritance. It will make available the\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\n * the functions of your contract. Note that they will not be pausable by\n * simply including this module, only once the modifiers are put in place.\n */\nabstract contract Pausable is Context {\n /**\n * @dev Emitted when the pause is triggered by `account`.\n */\n event Paused(address account);\n\n /**\n * @dev Emitted when the pause is lifted by `account`.\n */\n event Unpaused(address account);\n\n bool private _paused;\n\n /**\n * @dev Initializes the contract in unpaused state.\n */\n constructor() {\n _paused = false;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is not paused.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n modifier whenNotPaused() {\n _requireNotPaused();\n _;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is paused.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n modifier whenPaused() {\n _requirePaused();\n _;\n }\n\n /**\n * @dev Returns true if the contract is paused, and false otherwise.\n */\n function paused() public view virtual returns (bool) {\n return _paused;\n }\n\n /**\n * @dev Throws if the contract is paused.\n */\n function _requireNotPaused() internal view virtual {\n require(!paused(), \"Pausable: paused\");\n }\n\n /**\n * @dev Throws if the contract is not paused.\n */\n function _requirePaused() internal view virtual {\n require(paused(), \"Pausable: not paused\");\n }\n\n /**\n * @dev Triggers stopped state.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n function _pause() internal virtual whenNotPaused {\n _paused = true;\n emit Paused(_msgSender());\n }\n\n /**\n * @dev Returns to normal state.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n function _unpause() internal virtual whenPaused {\n _paused = false;\n emit Unpaused(_msgSender());\n }\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n */\ninterface IERC20Permit {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/IERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20Permit token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Address.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Context.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/ERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC165.sol\";\n\n/**\n * @dev Implementation of the {IERC165} interface.\n *\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\n * for the additional interface id that will be supported. For example:\n *\n * ```solidity\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\n * }\n * ```\n *\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\n */\nabstract contract ERC165 is IERC165 {\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IERC165).interfaceId;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/IERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC165 standard, as defined in the\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\n *\n * Implementers can declare support of contract interfaces, which can then be\n * queried by others ({ERC165Checker}).\n *\n * For an implementation, see {ERC165}.\n */\ninterface IERC165 {\n /**\n * @dev Returns true if this contract implements the interface defined by\n * `interfaceId`. See the corresponding\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\n * to learn more about how these ids are created.\n *\n * This function call must use less than 30 000 gas.\n */\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\";\n\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlledV8\n * @author Venus\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\n */\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\n /// @notice Access control manager contract\n IAccessControlManagerV8 private _accessControlManager;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n\n /// @notice Emitted when access control manager contract address is changed\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\n\n /// @notice Thrown when the action is prohibited by AccessControlManager\n error Unauthorized(address sender, address calledContract, string methodSignature);\n\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\n __Ownable2Step_init();\n __AccessControlled_init_unchained(accessControlManager_);\n }\n\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Sets the address of AccessControlManager\n * @dev Admin function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n * @custom:event Emits NewAccessControlManager event\n * @custom:access Only Governance\n */\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Returns the address of the access control manager contract\n */\n function accessControlManager() external view returns (IAccessControlManagerV8) {\n return _accessControlManager;\n }\n\n /**\n * @dev Internal function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n */\n function _setAccessControlManager(address accessControlManager_) internal {\n require(address(accessControlManager_) != address(0), \"invalid acess control manager address\");\n address oldAccessControlManager = address(_accessControlManager);\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\n }\n\n /**\n * @notice Reverts if the call is not allowed by AccessControlManager\n * @param signature Method signature\n */\n function _checkAccessAllowed(string memory signature) internal view {\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\n\n if (!isAllowedToCall) {\n revert Unauthorized(msg.sender, address(this), signature);\n }\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\nimport \"@openzeppelin/contracts/access/IAccessControl.sol\";\n\n/**\n * @title IAccessControlManagerV8\n * @author Venus\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\n */\ninterface IAccessControlManagerV8 is IAccessControl {\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\n\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) external;\n\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\n\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) external view returns (bool);\n}\n" + }, + "@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface OracleInterface {\n function getPrice(address asset) external view returns (uint256);\n}\n\ninterface ResilientOracleInterface is OracleInterface {\n function updatePrice(address vToken) external;\n\n function updateAssetPrice(address asset) external;\n\n function getUnderlyingPrice(address vToken) external view returns (uint256);\n}\n\ninterface TwapInterface is OracleInterface {\n function updateTwap(address asset) external returns (uint256);\n}\n\ninterface BoundValidatorInterface {\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool);\n}\n" + }, + "@venusprotocol/solidity-utilities/contracts/constants.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\nuint256 constant EXP_SCALE = 1e18;\n\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\nuint256 constant MANTISSA_ONE = EXP_SCALE;\n\n/// @dev The approximate number of seconds per year\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\n" + }, + "@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \"./constants.sol\";\n\n/**\n * @title Exponential module for storing fixed-precision decimals\n * @author Compound\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\n * `Exp({mantissa: 5100000000000000000})`.\n */\ncontract ExponentialNoError {\n struct Exp {\n uint256 mantissa;\n }\n\n struct Double {\n uint256 mantissa;\n }\n\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\n uint256 internal constant DOUBLE_SCALE = 1e36;\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\n\n /**\n * @dev Truncates the given exp to a whole number value.\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\n */\n function truncate(Exp memory exp) internal pure returns (uint256) {\n // Note: We are not using careful math here as we're performing a division that cannot fail\n return exp.mantissa / EXP_SCALE;\n }\n\n /**\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return truncate(product);\n }\n\n /**\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return add_(truncate(product), addend);\n }\n\n /**\n * @dev Checks if first Exp is less than second Exp.\n */\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\n return left.mantissa < right.mantissa;\n }\n\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\n require(n <= type(uint224).max, errorMessage);\n return uint224(n);\n }\n\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\n require(n <= type(uint32).max, errorMessage);\n return uint32(n);\n }\n\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a + b;\n }\n\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a - b;\n }\n\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\n }\n\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / EXP_SCALE;\n }\n\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\n }\n\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\n }\n\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a * b;\n }\n\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\n }\n\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return div_(mul_(a, EXP_SCALE), b.mantissa);\n }\n\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\n }\n\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\n }\n\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a / b;\n }\n\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\n }\n}\n" + }, + "@venusprotocol/solidity-utilities/contracts/validators.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\nerror ZeroAddressNotAllowed();\n\n/// @notice Thrown if the supplied value is 0 where it is not allowed\nerror ZeroValueNotAllowed();\n\n/// @notice Checks if the provided address is nonzero, reverts otherwise\n/// @param address_ Address to check\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\nfunction ensureNonzeroAddress(address address_) pure {\n if (address_ == address(0)) {\n revert ZeroAddressNotAllowed();\n }\n}\n\n/// @notice Checks if the provided value is nonzero, reverts otherwise\n/// @param value_ Value to check\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\nfunction ensureNonzeroValue(uint256 value_) pure {\n if (value_ == 0) {\n revert ZeroValueNotAllowed();\n }\n}\n" + }, + "contracts/Bridge/BaseXVSProxyOFT.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ResilientOracleInterface } from \"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { BaseOFTV2 } from \"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { ExponentialNoError } from \"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\";\n\n/**\n * @title BaseXVSProxyOFT\n * @author Venus\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\n * It manages transaction limits of a single and daily transactions.\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\n */\n\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\n using SafeERC20 for IERC20;\n IERC20 internal immutable innerToken;\n uint256 internal immutable ld2sdRate;\n bool public sendAndCallEnabled;\n\n /**\n * @notice The address of ResilientOracle contract wrapped in its interface.\n */\n ResilientOracleInterface public oracle;\n /**\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\n /**\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\n /**\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\n /**\n * @notice Timestamp when the last 24-hour window started from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\n /**\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\n /**\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\n /**\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\n /**\n * @notice Timestamp when the last 24-hour window started from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\n /**\n * @notice Address on which cap check and bound limit is not applicable.\n */\n mapping(address => bool) public whitelist;\n\n /**\n * @notice Emitted when address is added to whitelist.\n */\n event SetWhitelist(address indexed addr, bool isWhitelist);\n /**\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\n */\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\n */\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\n */\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\n */\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Event emitted when oracle is modified.\n */\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\n /**\n * @notice Event emitted when trusted remote sets to empty.\n */\n event TrustedRemoteRemoved(uint16 chainId);\n /**\n * @notice Event emitted when inner token set successfully.\n */\n event InnerTokenAdded(address indexed innerToken);\n /**\n *@notice Emitted on sweep token success\n */\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\n /**\n * @notice Event emitted when SendAndCallEnabled updated successfully.\n */\n event UpdateSendAndCallEnabled(bool indexed enabled);\n /**\n *@notice Error thrown when this contract balance is less than sweep amount\n */\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\n\n /**\n * @param tokenAddress_ Address of the inner token.\n * @param sharedDecimals_ Number of shared decimals.\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\n * @param oracle_ Address of the price oracle.\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\n * @custom:event Emits InnerTokenAdded with token address.\n * @custom:event Emits OracleChanged with zero address and oracle address.\n */\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\n ensureNonzeroAddress(tokenAddress_);\n ensureNonzeroAddress(lzEndpoint_);\n ensureNonzeroAddress(oracle_);\n\n innerToken = IERC20(tokenAddress_);\n\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\"decimals()\"));\n require(success, \"ProxyOFT: failed to get token decimals\");\n uint8 decimals = abi.decode(data, (uint8));\n\n require(sharedDecimals_ <= decimals, \"ProxyOFT: sharedDecimals must be <= decimals\");\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\n\n emit InnerTokenAdded(tokenAddress_);\n emit OracleChanged(address(0), oracle_);\n\n oracle = ResilientOracleInterface(oracle_);\n }\n\n /**\n * @notice Set the address of the ResilientOracle contract.\n * @dev Reverts if the new address is zero.\n * @param oracleAddress_ The new address of the ResilientOracle contract.\n * @custom:access Only owner.\n * @custom:event Emits OracleChanged with old and new oracle address.\n */\n function setOracle(address oracleAddress_) external onlyOwner {\n ensureNonzeroAddress(oracleAddress_);\n emit OracleChanged(address(oracle), oracleAddress_);\n oracle = ResilientOracleInterface(oracleAddress_);\n }\n\n /**\n * @notice Sets the limit of single transaction amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \"Single transaction limit > Daily limit\");\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the limit of daily (24 Hour) transactions amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\n */\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \"Daily limit < single transaction limit\");\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\n chainIdToMaxDailyLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum limit for a single receive transaction.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \"single receive transaction limit > Daily limit\");\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum daily limit for receiving transactions.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\n */\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\n \"Daily limit < single receive transaction limit\"\n );\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the whitelist address to skip checks on transaction limit.\n * @param user_ Address to be add in whitelist.\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\n * @custom:access Only owner.\n * @custom:event Emits setWhitelist.\n */\n function setWhitelist(address user_, bool val_) external onlyOwner {\n emit SetWhitelist(user_, val_);\n whitelist[user_] = val_;\n }\n\n /**\n * @notice Triggers stopped state of the bridge.\n * @custom:access Only owner.\n */\n function pause() external onlyOwner {\n _pause();\n }\n\n /**\n * @notice Triggers resume state of the bridge.\n * @custom:access Only owner.\n */\n function unpause() external onlyOwner {\n _unpause();\n }\n\n /**\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\n * @param token_ The address of the ERC-20 token to sweep\n * @param to_ The address of the recipient\n * @param amount_ The amount of tokens needs to transfer\n * @custom:event Emits SweepToken event\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\n * @custom:access Only Owner\n */\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\n uint256 balance = token_.balanceOf(address(this));\n if (amount_ > balance) {\n revert InsufficientBalance(amount_, balance);\n }\n\n emit SweepToken(address(token_), to_, amount_);\n\n token_.safeTransfer(to_, amount_);\n }\n\n /**\n * @notice Remove trusted remote from storage.\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\n * @custom:access Only owner.\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\n */\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\n delete trustedRemoteLookup[remoteChainId_];\n emit TrustedRemoteRemoved(remoteChainId_);\n }\n\n /**\n * @notice It enables or disables sendAndCall functionality for the bridge.\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\n */\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\n sendAndCallEnabled = enabled_;\n emit UpdateSendAndCallEnabled(enabled_);\n }\n\n /**\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\n * @param from_ The sender's address initiating the transfer.\n * @param dstChainId_ Indicates destination chain.\n * @param amount_ The quantity of tokens to be transferred.\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\n * @return maxDailyLimit The maximum daily limit for transactions.\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\n */\n function isEligibleToSend(\n address from_,\n uint16 dstChainId_,\n uint256 amount_\n )\n external\n view\n returns (\n bool eligibleToSend,\n uint256 maxSingleTransactionLimit,\n uint256 maxDailyLimit,\n uint256 amountInUsd,\n uint256 transferredInWindow,\n uint256 last24HourWindowStart,\n bool isWhiteListedUser\n )\n {\n // Check if the sender's address is whitelisted\n isWhiteListedUser = whitelist[from_];\n\n // Calculate the amount in USD using the oracle price\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n last24HourWindowStart = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n eligibleToSend = (isWhiteListedUser ||\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\n }\n\n /**\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\n * @param from_ Address from which tokens will be debited.\n * @param dstChainId_ Destination chain id on which tokens will be send.\n * @param toAddress_ Address on which tokens will be credited on destination chain.\n * @param amount_ Amount of tokens that will be transferred.\n * @param payload_ Additional data payload for the call on the destination chain.\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\n * and adapter params.\n */\n function sendAndCall(\n address from_,\n uint16 dstChainId_,\n bytes32 toAddress_,\n uint256 amount_,\n bytes calldata payload_,\n uint64 dstGasForCall_,\n LzCallParams calldata callparams_\n ) public payable override {\n require(sendAndCallEnabled, \"sendAndCall is disabled\");\n\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\n }\n\n function retryMessage(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public payable override {\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\n require(\n _srcAddress.length == trustedRemote.length &&\n trustedRemote.length > 0 &&\n keccak256(_srcAddress) == keccak256(trustedRemote),\n \"LzApp: invalid source sending contract\"\n );\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @notice Return's the address of the inner token of this bridge.\n * @return Address of the inner token of this bridge.\n */\n function token() public view override returns (address) {\n return address(innerToken);\n }\n\n /**\n * @notice Checks if the sender is eligible to send tokens\n * @param from_ Sender's address sending tokens\n * @param dstChainId_ Chain id on which tokens should be sent\n * @param amount_ Amount of tokens to be sent\n */\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\n // Check if the sender's address is whitelisted\n bool isWhiteListedUser = whitelist[from_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the amount in USD using the oracle price\n uint256 amountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n\n // Revert if the amount exceeds the single transaction limit\n require(amountInUsd <= maxSingleTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n\n // Revert if the amount exceeds the daily limit\n require(transferredInWindow <= maxDailyLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the amount for the 24-hour window\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\n }\n\n /**\n * @notice Checks if receiver is able to receive tokens\n * @param toAddress_ Receiver address\n * @param srcChainId_ Source chain id from which token is send\n * @param receivedAmount_ Amount of tokens received\n */\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\n // Check if the recipient's address is whitelisted\n bool isWhiteListedUser = whitelist[toAddress_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the received amount in USD using the oracle price\n uint256 receivedAmountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\n\n uint256 currentBlockTimestamp = block.timestamp;\n\n // Load values for the 24-hour window checks for receiving\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\n\n // Check if the received amount exceeds the single transaction limit\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\n receivedInWindow = receivedAmountInUsd;\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\n } else {\n receivedInWindow += receivedAmountInUsd;\n }\n\n // Revert if the received amount exceeds the daily limit\n require(receivedInWindow <= maxDailyReceiveLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the received amount for the 24-hour window\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\n }\n\n /**\n * @notice Transfer tokens from sender to receiver account.\n * @param from_ Address from which token has to be transferred(Sender).\n * @param to_ Address on which token will be tranferred(Receiver).\n * @param amount_ Amount of token to be transferred.\n * @return Actual balance difference.\n */\n function _transferFrom(\n address from_,\n address to_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n uint256 before = innerToken.balanceOf(to_);\n if (from_ == address(this)) {\n innerToken.safeTransfer(to_, amount_);\n } else {\n innerToken.safeTransferFrom(from_, to_, amount_);\n }\n return innerToken.balanceOf(to_) - before;\n }\n\n /**\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\n * @return Conversion rate factor.\n */\n function _ld2sdRate() internal view override returns (uint256) {\n return ld2sdRate;\n }\n}\n" + }, + "contracts/Bridge/interfaces/IXVS.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/**\n * @title IXVS\n * @author Venus\n * @notice Interface implemented by `XVS` token.\n */\ninterface IXVS {\n function mint(address to, uint256 amount) external;\n\n function burn(address from, uint256 amount) external;\n}\n" + }, + "contracts/Bridge/interfaces/IXVSProxyOFT.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/**\n * @title IXVSProxyOFT\n * @author Venus\n * @notice Interface implemented by `XVSProxyOFT`.\n */\ninterface IXVSProxyOFT {\n function transferOwnership(address addr) external;\n\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\n\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\n}\n" + }, + "contracts/Bridge/XVSBridgeAdmin.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { AccessControlledV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { IXVSProxyOFT } from \"./interfaces/IXVSProxyOFT.sol\";\n\n/**\n * @title XVSBridgeAdmin\n * @author Venus\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\n * It maintains a registry of function signatures and names,\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\n */\ncontract XVSBridgeAdmin is AccessControlledV8 {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IXVSProxyOFT public immutable XVSBridge;\n /**\n * @notice A mapping keeps track of function signature associated with function name string.\n */\n mapping(bytes4 => string) public functionRegistry;\n\n /**\n * @notice emitted when function registry updated\n */\n event FunctionRegistryChanged(string signature, bool active);\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address XVSBridge_) {\n ensureNonzeroAddress(XVSBridge_);\n XVSBridge = IXVSProxyOFT(XVSBridge_);\n _disableInitializers();\n }\n\n /**\n * @param accessControlManager_ Address of access control manager contract.\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Invoked when called function does not exist in the contract.\n * @return Response of low level call.\n * @custom:access Controlled by AccessControlManager.\n */\n fallback(bytes calldata data) external returns (bytes memory) {\n string memory fun = _getFunctionName(msg.sig);\n require(bytes(fun).length != 0, \"Function not found\");\n _checkAccessAllowed(fun);\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\n require(ok, \"call failed\");\n return res;\n }\n\n /**\n * @notice Sets trusted remote on particular chain.\n * @param remoteChainId_ Chain Id of the destination chain.\n * @param remoteAddress_ Address of the destination bridge.\n * @custom:access Controlled by AccessControlManager.\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\n */\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\n _checkAccessAllowed(\"setTrustedRemoteAddress(uint16,bytes)\");\n require(remoteChainId_ != 0, \"ChainId must not be zero\");\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\n }\n\n /**\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\n * @param signatures_ Function signature to be added or removed.\n * @param active_ bool value, should be true to add function.\n * @custom:access Only owner.\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\n */\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\n uint256 signatureLength = signatures_.length;\n require(signatureLength == active_.length, \"Input arrays must have the same length\");\n for (uint256 i; i < signatureLength; ) {\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\n bytes memory signature = bytes(functionRegistry[sigHash]);\n if (active_[i] && signature.length == 0) {\n functionRegistry[sigHash] = signatures_[i];\n emit FunctionRegistryChanged(signatures_[i], true);\n } else if (!active_[i] && signature.length != 0) {\n delete functionRegistry[sigHash];\n emit FunctionRegistryChanged(signatures_[i], false);\n }\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\n * @param newOwner_ New owner of the XVS Bridge.\n * @custom:access Controlled by AccessControlManager.\n */\n function transferBridgeOwnership(address newOwner_) external {\n _checkAccessAllowed(\"transferBridgeOwnership(address)\");\n XVSBridge.transferOwnership(newOwner_);\n }\n\n /**\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\n * @param remoteChainId_ Chain Id of the destination chain.\n * @param remoteAddress_ Address of the destination bridge.\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\n * @return Bool indicating whether the remote chain is trusted or not.\n */\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\n require(remoteChainId_ != 0, \"ChainId must not be zero\");\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @dev Returns function name string associated with function signature.\n * @param signature_ Four bytes of function signature.\n * @return Function signature corresponding to its hash.\n */\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\n return functionRegistry[signature_];\n }\n\n /**\n * @notice Converts given bytes into address.\n * @param b Bytes to be converted into address.\n * @return Converted address of given bytes.\n */\n function bytesToAddress(bytes calldata b) private pure returns (address) {\n return address(uint160(bytes20(b)));\n }\n}\n" + }, + "contracts/Bridge/XVSProxyOFTDest.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IXVS } from \"./interfaces/IXVS.sol\";\nimport { BaseXVSProxyOFT } from \"./BaseXVSProxyOFT.sol\";\n\n/**\n * @title XVSProxyOFTDest\n * @author Venus\n * @notice XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT,\n * and focuses on managing token transfers to the destination chain.\n * It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\n */\n\ncontract XVSProxyOFTDest is BaseXVSProxyOFT {\n /**\n * @notice Emits when stored message dropped without successful retrying.\n */\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\n\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\n\n /**\n * @notice Clear failed messages from the storage.\n * @param srcChainId_ Chain id of source\n * @param srcAddress_ Address of source followed by current bridge address\n * @param nonce_ Nonce_ of the transaction\n * @custom:access Only owner\n * @custom:event Emits DropFailedMessage on clearance of failed message.\n */\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\n }\n\n /**\n * @notice Returns the total circulating supply of the token on the destination chain i.e (total supply).\n * @return total circulating supply of the token on the destination chain.\n */\n function circulatingSupply() public view override returns (uint256) {\n return innerToken.totalSupply();\n }\n\n /**\n * @notice Debit tokens from the given address\n * @param from_ Address from which tokens to be debited\n * @param dstChainId_ Destination chain id\n * @param amount_ Amount of tokens to be debited\n * @return Actual amount debited\n */\n function _debitFrom(\n address from_,\n uint16 dstChainId_,\n bytes32,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n require(from_ == _msgSender(), \"ProxyOFT: owner is not send caller\");\n _isEligibleToSend(from_, dstChainId_, amount_);\n IXVS(address(innerToken)).burn(from_, amount_);\n return amount_;\n }\n\n /**\n * @notice Credit tokens in the given account\n * @param srcChainId_ Source chain id\n * @param toAddress_ Address on which token will be credited\n * @param amount_ Amount of tokens to be credited\n * @return Actual amount credited\n */\n function _creditTo(\n uint16 srcChainId_,\n address toAddress_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\n IXVS(address(innerToken)).mint(toAddress_, amount_);\n return amount_;\n }\n}\n" + }, + "contracts/Bridge/XVSProxyOFTSrc.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BaseXVSProxyOFT } from \"./BaseXVSProxyOFT.sol\";\n\n/**\n * @title XVSProxyOFTSrc\n * @author Venus\n * @notice XVSProxyOFTSrc contract serves as a crucial component for cross-chain token transactions,\n * focusing on the source side of these transactions.\n * It monitors the total amount transferred to other chains, ensuring it complies with defined limits,\n * and provides functions for transferring tokens while maintaining control over the circulating supply on the source chain.\n */\n\ncontract XVSProxyOFTSrc is BaseXVSProxyOFT {\n using SafeERC20 for IERC20;\n /**\n * @notice Total amount that is transferred from this chain to other chains.\n */\n uint256 public outboundAmount;\n\n /**\n * @notice Emits when locked token released manually by owner.\n */\n event FallbackWithdraw(address indexed to, uint256 amount);\n /**\n * @notice Emits when stored message dropped without successful retrying.\n */\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\n /**\n * @notice Event emitted when tokens are forcefully locked.\n */\n event FallbackDeposit(address indexed from, uint256 amount_);\n\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\n\n /**\n * @notice Only call it when there is no way to recover the failed message.\n * `dropFailedMessage` must be called first if transaction is from remote->local chain to avoid double spending.\n * @param to_ The address to withdraw to\n * @param amount_ The amount of withdrawal\n * @custom:access Only owner.\n * @custom:event Emits FallbackWithdraw, once done with transfer.\n */\n function fallbackWithdraw(address to_, uint256 amount_) external onlyOwner {\n require(outboundAmount >= amount_, \"Withdraw amount should be less than outbound amount\");\n unchecked {\n outboundAmount -= amount_;\n }\n _transferFrom(address(this), to_, amount_);\n emit FallbackWithdraw(to_, amount_);\n }\n\n /**\n * @notice Forces the lock of tokens by increasing outbound amount and transferring tokens from the sender to the contract.\n * @param amount_ The amount of tokens to lock.\n * @param depositor_ Address of the depositor.\n * @custom:access Only owner.\n * @custom:event Emits FallbackDeposit, once done with transfer.\n */\n function fallbackDeposit(address depositor_, uint256 amount_) external onlyOwner {\n (uint256 actualAmount, ) = _removeDust(amount_);\n\n outboundAmount += actualAmount;\n uint256 cap = _sd2ld(type(uint64).max);\n require(cap >= outboundAmount, \"ProxyOFT: outboundAmount overflow\");\n\n _transferFrom(depositor_, address(this), actualAmount);\n\n emit FallbackDeposit(depositor_, actualAmount);\n }\n\n /**\n * @notice Clear failed messages from the storage.\n * @param srcChainId_ Chain id of source\n * @param srcAddress_ Address of source followed by current bridge address\n * @param nonce_ Nonce_ of the transaction\n * @custom:access Only owner.\n * @custom:event Emits DropFailedMessage on clearance of failed message.\n */\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\n }\n\n /**\n * @notice Returns the total circulating supply of the token on the source chain i.e (total supply - locked in this contract).\n * @return Returns difference in total supply and the outbound amount.\n */\n function circulatingSupply() public view override returns (uint256) {\n return innerToken.totalSupply() - outboundAmount;\n }\n\n /**\n * @notice Debit tokens from the given address\n * @param from_ Address from which tokens to be debited\n * @param dstChainId_ Destination chain id\n * @param amount_ Amount of tokens to be debited\n * @return Actual amount debited\n */\n function _debitFrom(\n address from_,\n uint16 dstChainId_,\n bytes32,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n require(from_ == _msgSender(), \"ProxyOFT: owner is not send caller\");\n _isEligibleToSend(from_, dstChainId_, amount_);\n\n uint256 amount = _transferFrom(from_, address(this), amount_);\n\n outboundAmount += amount;\n uint256 cap = _sd2ld(type(uint64).max);\n require(cap >= outboundAmount, \"ProxyOFT: outboundAmount overflow\");\n\n return amount;\n }\n\n /**\n * @notice Credit tokens in the given account\n * @param srcChainId_ Source chain id\n * @param toAddress_ Address on which token will be credited\n * @param amount_ Amount of tokens to be credited\n * @return Actual amount credited\n */\n function _creditTo(\n uint16 srcChainId_,\n address toAddress_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\n outboundAmount -= amount_;\n // tokens are already in this contract, so no need to transfer\n if (toAddress_ == address(this)) {\n return amount_;\n }\n\n return _transferFrom(address(this), toAddress_, amount_);\n }\n}\n" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 200, + "details": { + "yul": true + } + }, + "evmVersion": "paris", + "outputSelection": { + "*": { + "*": [ + "storageLayout", + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "evm.gasEstimates" + ], + "": ["ast"] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} diff --git a/deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json b/deployments/arbitrumsepolia/solcInputs/c5caaaafd4ca2aaf0d7d76349c623fb6.json similarity index 77% rename from deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json rename to deployments/arbitrumsepolia/solcInputs/c5caaaafd4ca2aaf0d7d76349c623fb6.json index 556e3c9..32332bd 100644 --- a/deployments/arbitrumsepolia/solcInputs/f2046c3ab03975d1be43bca1cf657398.json +++ b/deployments/arbitrumsepolia/solcInputs/c5caaaafd4ca2aaf0d7d76349c623fb6.json @@ -43,21 +43,6 @@ "@layerzerolabs/solidity-examples/contracts/token/oft/v2/OFTCoreV2.sol": { "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport \"../../../lzApp/NonblockingLzApp.sol\";\nimport \"../../../libraries/ExcessivelySafeCall.sol\";\nimport \"./interfaces/ICommonOFT.sol\";\nimport \"./interfaces/IOFTReceiverV2.sol\";\n\nabstract contract OFTCoreV2 is NonblockingLzApp {\n using BytesLib for bytes;\n using ExcessivelySafeCall for address;\n\n uint public constant NO_EXTRA_GAS = 0;\n\n // packet type\n uint8 public constant PT_SEND = 0;\n uint8 public constant PT_SEND_AND_CALL = 1;\n\n uint8 public immutable sharedDecimals;\n\n mapping(uint16 => mapping(bytes => mapping(uint64 => bool))) public creditedPackets;\n\n /**\n * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)\n * `_nonce` is the outbound nonce\n */\n event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes32 indexed _toAddress, uint _amount);\n\n /**\n * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.\n * `_nonce` is the inbound nonce.\n */\n event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);\n\n event CallOFTReceivedSuccess(uint16 indexed _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _hash);\n\n event NonContractAddress(address _address);\n\n // _sharedDecimals should be the minimum decimals on all chains\n constructor(uint8 _sharedDecimals, address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {\n sharedDecimals = _sharedDecimals;\n }\n\n /************************************************************************\n * public functions\n ************************************************************************/\n function callOnOFTReceived(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes32 _from,\n address _to,\n uint _amount,\n bytes calldata _payload,\n uint _gasForCall\n ) public virtual {\n require(_msgSender() == address(this), \"OFTCore: caller must be OFTCore\");\n\n // send\n _amount = _transferFrom(address(this), _to, _amount);\n emit ReceiveFromChain(_srcChainId, _to, _amount);\n\n // call\n IOFTReceiverV2(_to).onOFTReceived{gas: _gasForCall}(_srcChainId, _srcAddress, _nonce, _from, _amount, _payload);\n }\n\n /************************************************************************\n * internal functions\n ************************************************************************/\n function _estimateSendFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bool _useZro,\n bytes memory _adapterParams\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\n // mock the payload for sendFrom()\n bytes memory payload = _encodeSendPayload(_toAddress, _ld2sd(_amount));\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\n }\n\n function _estimateSendAndCallFee(\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes memory _payload,\n uint64 _dstGasForCall,\n bool _useZro,\n bytes memory _adapterParams\n ) internal view virtual returns (uint nativeFee, uint zroFee) {\n // mock the payload for sendAndCall()\n bytes memory payload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(_amount), _payload, _dstGasForCall);\n return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);\n }\n\n function _nonblockingLzReceive(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual override {\n uint8 packetType = _payload.toUint8(0);\n\n if (packetType == PT_SEND) {\n _sendAck(_srcChainId, _srcAddress, _nonce, _payload);\n } else if (packetType == PT_SEND_AND_CALL) {\n _sendAndCallAck(_srcChainId, _srcAddress, _nonce, _payload);\n } else {\n revert(\"OFTCore: unknown packet type\");\n }\n }\n\n function _send(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) internal virtual returns (uint amount) {\n _checkGasLimit(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);\n\n (amount, ) = _removeDust(_amount);\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount); // amount returned should not have dust\n require(amount > 0, \"OFTCore: amount too small\");\n\n bytes memory lzPayload = _encodeSendPayload(_toAddress, _ld2sd(amount));\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\n\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\n }\n\n function _sendAck(\n uint16 _srcChainId,\n bytes memory,\n uint64,\n bytes memory _payload\n ) internal virtual {\n (address to, uint64 amountSD) = _decodeSendPayload(_payload);\n if (to == address(0)) {\n to = address(0xdead);\n }\n\n uint amount = _sd2ld(amountSD);\n amount = _creditTo(_srcChainId, to, amount);\n\n emit ReceiveFromChain(_srcChainId, to, amount);\n }\n\n function _sendAndCall(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount,\n bytes memory _payload,\n uint64 _dstGasForCall,\n address payable _refundAddress,\n address _zroPaymentAddress,\n bytes memory _adapterParams\n ) internal virtual returns (uint amount) {\n _checkGasLimit(_dstChainId, PT_SEND_AND_CALL, _adapterParams, _dstGasForCall);\n\n (amount, ) = _removeDust(_amount);\n amount = _debitFrom(_from, _dstChainId, _toAddress, amount);\n require(amount > 0, \"OFTCore: amount too small\");\n\n // encode the msg.sender into the payload instead of _from\n bytes memory lzPayload = _encodeSendAndCallPayload(msg.sender, _toAddress, _ld2sd(amount), _payload, _dstGasForCall);\n _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);\n\n emit SendToChain(_dstChainId, _from, _toAddress, amount);\n }\n\n function _sendAndCallAck(\n uint16 _srcChainId,\n bytes memory _srcAddress,\n uint64 _nonce,\n bytes memory _payload\n ) internal virtual {\n (bytes32 from, address to, uint64 amountSD, bytes memory payloadForCall, uint64 gasForCall) = _decodeSendAndCallPayload(_payload);\n\n bool credited = creditedPackets[_srcChainId][_srcAddress][_nonce];\n uint amount = _sd2ld(amountSD);\n\n // credit to this contract first, and then transfer to receiver only if callOnOFTReceived() succeeds\n if (!credited) {\n amount = _creditTo(_srcChainId, address(this), amount);\n creditedPackets[_srcChainId][_srcAddress][_nonce] = true;\n }\n\n if (!_isContract(to)) {\n emit NonContractAddress(to);\n return;\n }\n\n // workaround for stack too deep\n uint16 srcChainId = _srcChainId;\n bytes memory srcAddress = _srcAddress;\n uint64 nonce = _nonce;\n bytes memory payload = _payload;\n bytes32 from_ = from;\n address to_ = to;\n uint amount_ = amount;\n bytes memory payloadForCall_ = payloadForCall;\n\n // no gas limit for the call if retry\n uint gas = credited ? gasleft() : gasForCall;\n (bool success, bytes memory reason) = address(this).excessivelySafeCall(\n gasleft(),\n 150,\n abi.encodeWithSelector(this.callOnOFTReceived.selector, srcChainId, srcAddress, nonce, from_, to_, amount_, payloadForCall_, gas)\n );\n\n if (success) {\n bytes32 hash = keccak256(payload);\n emit CallOFTReceivedSuccess(srcChainId, srcAddress, nonce, hash);\n } else {\n // store the failed message into the nonblockingLzApp\n _storeFailedMessage(srcChainId, srcAddress, nonce, payload, reason);\n }\n }\n\n function _isContract(address _account) internal view returns (bool) {\n return _account.code.length > 0;\n }\n\n function _ld2sd(uint _amount) internal view virtual returns (uint64) {\n uint amountSD = _amount / _ld2sdRate();\n require(amountSD <= type(uint64).max, \"OFTCore: amountSD overflow\");\n return uint64(amountSD);\n }\n\n function _sd2ld(uint64 _amountSD) internal view virtual returns (uint) {\n return _amountSD * _ld2sdRate();\n }\n\n function _removeDust(uint _amount) internal view virtual returns (uint amountAfter, uint dust) {\n dust = _amount % _ld2sdRate();\n amountAfter = _amount - dust;\n }\n\n function _encodeSendPayload(bytes32 _toAddress, uint64 _amountSD) internal view virtual returns (bytes memory) {\n return abi.encodePacked(PT_SEND, _toAddress, _amountSD);\n }\n\n function _decodeSendPayload(bytes memory _payload) internal view virtual returns (address to, uint64 amountSD) {\n require(_payload.toUint8(0) == PT_SEND && _payload.length == 41, \"OFTCore: invalid payload\");\n\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\n amountSD = _payload.toUint64(33);\n }\n\n function _encodeSendAndCallPayload(\n address _from,\n bytes32 _toAddress,\n uint64 _amountSD,\n bytes memory _payload,\n uint64 _dstGasForCall\n ) internal view virtual returns (bytes memory) {\n return abi.encodePacked(PT_SEND_AND_CALL, _toAddress, _amountSD, _addressToBytes32(_from), _dstGasForCall, _payload);\n }\n\n function _decodeSendAndCallPayload(bytes memory _payload)\n internal\n view\n virtual\n returns (\n bytes32 from,\n address to,\n uint64 amountSD,\n bytes memory payload,\n uint64 dstGasForCall\n )\n {\n require(_payload.toUint8(0) == PT_SEND_AND_CALL, \"OFTCore: invalid payload\");\n\n to = _payload.toAddress(13); // drop the first 12 bytes of bytes32\n amountSD = _payload.toUint64(33);\n from = _payload.toBytes32(41);\n dstGasForCall = _payload.toUint64(73);\n payload = _payload.slice(81, _payload.length - 81);\n }\n\n function _addressToBytes32(address _address) internal pure virtual returns (bytes32) {\n return bytes32(uint(uint160(_address)));\n }\n\n function _debitFrom(\n address _from,\n uint16 _dstChainId,\n bytes32 _toAddress,\n uint _amount\n ) internal virtual returns (uint);\n\n function _creditTo(\n uint16 _srcChainId,\n address _toAddress,\n uint _amount\n ) internal virtual returns (uint);\n\n function _transferFrom(\n address _from,\n address _to,\n uint _amount\n ) internal virtual returns (uint);\n\n function _ld2sdRate() internal view virtual returns (uint);\n}\n" }, - "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol": { - "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./OwnableUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership} and {acceptOwnership}.\n *\n * This module is used through inheritance. It will make available all functions\n * from parent (Ownable).\n */\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\n function __Ownable2Step_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable2Step_init_unchained() internal onlyInitializing {\n }\n address private _pendingOwner;\n\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Returns the address of the pending owner.\n */\n function pendingOwner() public view virtual returns (address) {\n return _pendingOwner;\n }\n\n /**\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual override onlyOwner {\n _pendingOwner = newOwner;\n emit OwnershipTransferStarted(owner(), newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual override {\n delete _pendingOwner;\n super._transferOwnership(newOwner);\n }\n\n /**\n * @dev The new owner accepts the ownership transfer.\n */\n function acceptOwnership() public virtual {\n address sender = _msgSender();\n require(pendingOwner() == sender, \"Ownable2Step: caller is not the new owner\");\n _transferOwnership(sender);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" - }, - "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol": { - "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n function __Ownable_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable_init_unchained() internal onlyInitializing {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" - }, - "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": { - "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n" - }, - "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": { - "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" - }, - "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol": { - "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract ContextUpgradeable is Initializable {\n function __Context_init() internal onlyInitializing {\n }\n\n function __Context_init_unchained() internal onlyInitializing {\n }\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n" - }, "@openzeppelin/contracts/access/AccessControl.sol": { "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControl.sol\";\nimport \"../utils/Context.sol\";\nimport \"../utils/Strings.sol\";\nimport \"../utils/introspection/ERC165.sol\";\n\n/**\n * @dev Contract module that allows children to implement role-based access\n * control mechanisms. This is a lightweight version that doesn't allow enumerating role\n * members except through off-chain means by accessing the contract event logs. Some\n * applications may benefit from on-chain enumerability, for those cases see\n * {AccessControlEnumerable}.\n *\n * Roles are referred to by their `bytes32` identifier. These should be exposed\n * in the external API and be unique. The best way to achieve this is by\n * using `public constant` hash digests:\n *\n * ```solidity\n * bytes32 public constant MY_ROLE = keccak256(\"MY_ROLE\");\n * ```\n *\n * Roles can be used to represent a set of permissions. To restrict access to a\n * function call, use {hasRole}:\n *\n * ```solidity\n * function foo() public {\n * require(hasRole(MY_ROLE, msg.sender));\n * ...\n * }\n * ```\n *\n * Roles can be granted and revoked dynamically via the {grantRole} and\n * {revokeRole} functions. Each role has an associated admin role, and only\n * accounts that have a role's admin role can call {grantRole} and {revokeRole}.\n *\n * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means\n * that only accounts with this role will be able to grant or revoke other\n * roles. More complex role relationships can be created by using\n * {_setRoleAdmin}.\n *\n * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to\n * grant and revoke this role. Extra precautions should be taken to secure\n * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}\n * to enforce additional security measures for this role.\n */\nabstract contract AccessControl is Context, IAccessControl, ERC165 {\n struct RoleData {\n mapping(address => bool) members;\n bytes32 adminRole;\n }\n\n mapping(bytes32 => RoleData) private _roles;\n\n bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;\n\n /**\n * @dev Modifier that checks that an account has a specific role. Reverts\n * with a standardized message including the required role.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n *\n * _Available since v4.1._\n */\n modifier onlyRole(bytes32 role) {\n _checkRole(role);\n _;\n }\n\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);\n }\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) public view virtual override returns (bool) {\n return _roles[role].members[account];\n }\n\n /**\n * @dev Revert with a standard message if `_msgSender()` is missing `role`.\n * Overriding this function changes the behavior of the {onlyRole} modifier.\n *\n * Format of the revert message is described in {_checkRole}.\n *\n * _Available since v4.6._\n */\n function _checkRole(bytes32 role) internal view virtual {\n _checkRole(role, _msgSender());\n }\n\n /**\n * @dev Revert with a standard message if `account` is missing `role`.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n */\n function _checkRole(bytes32 role, address account) internal view virtual {\n if (!hasRole(role, account)) {\n revert(\n string(\n abi.encodePacked(\n \"AccessControl: account \",\n Strings.toHexString(account),\n \" is missing role \",\n Strings.toHexString(uint256(role), 32)\n )\n )\n );\n }\n }\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {\n return _roles[role].adminRole;\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleGranted} event.\n */\n function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _grantRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleRevoked} event.\n */\n function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _revokeRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been revoked `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n *\n * May emit a {RoleRevoked} event.\n */\n function renounceRole(bytes32 role, address account) public virtual override {\n require(account == _msgSender(), \"AccessControl: can only renounce roles for self\");\n\n _revokeRole(role, account);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event. Note that unlike {grantRole}, this function doesn't perform any\n * checks on the calling account.\n *\n * May emit a {RoleGranted} event.\n *\n * [WARNING]\n * ====\n * This function should only be called from the constructor when setting\n * up the initial roles for the system.\n *\n * Using this function in any other way is effectively circumventing the admin\n * system imposed by {AccessControl}.\n * ====\n *\n * NOTE: This function is deprecated in favor of {_grantRole}.\n */\n function _setupRole(bytes32 role, address account) internal virtual {\n _grantRole(role, account);\n }\n\n /**\n * @dev Sets `adminRole` as ``role``'s admin role.\n *\n * Emits a {RoleAdminChanged} event.\n */\n function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {\n bytes32 previousAdminRole = getRoleAdmin(role);\n _roles[role].adminRole = adminRole;\n emit RoleAdminChanged(role, previousAdminRole, adminRole);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleGranted} event.\n */\n function _grantRole(bytes32 role, address account) internal virtual {\n if (!hasRole(role, account)) {\n _roles[role].members[account] = true;\n emit RoleGranted(role, account, _msgSender());\n }\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleRevoked} event.\n */\n function _revokeRole(bytes32 role, address account) internal virtual {\n if (hasRole(role, account)) {\n _roles[role].members[account] = false;\n emit RoleRevoked(role, account, _msgSender());\n }\n }\n}\n" }, @@ -106,50 +91,38 @@ "@openzeppelin/contracts/utils/Strings.sol": { "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n" }, - "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\";\n\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlledV8\n * @author Venus\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\n */\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\n /// @notice Access control manager contract\n IAccessControlManagerV8 private _accessControlManager;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n\n /// @notice Emitted when access control manager contract address is changed\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\n\n /// @notice Thrown when the action is prohibited by AccessControlManager\n error Unauthorized(address sender, address calledContract, string methodSignature);\n\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\n __Ownable2Step_init();\n __AccessControlled_init_unchained(accessControlManager_);\n }\n\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Sets the address of AccessControlManager\n * @dev Admin function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n * @custom:event Emits NewAccessControlManager event\n * @custom:access Only Governance\n */\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Returns the address of the access control manager contract\n */\n function accessControlManager() external view returns (IAccessControlManagerV8) {\n return _accessControlManager;\n }\n\n /**\n * @dev Internal function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n */\n function _setAccessControlManager(address accessControlManager_) internal {\n require(address(accessControlManager_) != address(0), \"invalid acess control manager address\");\n address oldAccessControlManager = address(_accessControlManager);\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\n }\n\n /**\n * @notice Reverts if the call is not allowed by AccessControlManager\n * @param signature Method signature\n */\n function _checkAccessAllowed(string memory signature) internal view {\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\n\n if (!isAllowedToCall) {\n revert Unauthorized(msg.sender, address(this), signature);\n }\n }\n}\n" - }, "@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlManager\n * @author Venus\n * @dev This contract is a wrapper of OpenZeppelin AccessControl extending it in a way to standartize access control within Venus Smart Contract Ecosystem.\n * @notice Access control plays a crucial role in the Venus governance model. It is used to restrict functions so that they can only be called from one\n * account or list of accounts (EOA or Contract Accounts).\n *\n * The implementation of `AccessControlManager`(https://github.com/VenusProtocol/governance-contracts/blob/main/contracts/Governance/AccessControlManager.sol)\n * inherits the [Open Zeppelin AccessControl](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/AccessControl.sol)\n * contract as a base for role management logic. There are two role types: admin and granular permissions.\n * \n * ## Granular Roles\n * \n * Granular roles are built by hashing the contract address and its function signature. For example, given contract `Foo` with function `Foo.bar()` which\n * is guarded by ACM, calling `giveRolePermission` for account B do the following:\n * \n * 1. Compute `keccak256(contractFooAddress,functionSignatureBar)`\n * 1. Add the computed role to the roles of account B\n * 1. Account B now can call `ContractFoo.bar()`\n * \n * ## Admin Roles\n * \n * Admin roles allow for an address to call a function signature on any contract guarded by the `AccessControlManager`. This is particularly useful for\n * contracts created by factories.\n * \n * For Admin roles a null address is hashed in place of the contract address (`keccak256(0x0000000000000000000000000000000000000000,functionSignatureBar)`.\n * \n * In the previous example, giving account B the admin role, account B will have permissions to call the `bar()` function on any contract that is guarded by\n * ACM, not only contract A.\n * \n * ## Protocol Integration\n * \n * All restricted functions in Venus Protocol use a hook to ACM in order to check if the caller has the right permission to call the guarded function.\n * `AccessControlledV5` and `AccessControlledV8` abstract contract makes this integration easier. They call ACM's external method\n * `isAllowedToCall(address caller, string functionSig)`. Here is an example of how `setCollateralFactor` function in `Comptroller` is integrated with ACM:\n\n```\n contract Comptroller is [...] AccessControlledV8 {\n [...]\n function setCollateralFactor(VToken vToken, uint256 newCollateralFactorMantissa, uint256 newLiquidationThresholdMantissa) external {\n _checkAccessAllowed(\"setCollateralFactor(address,uint256,uint256)\");\n [...]\n }\n }\n```\n */\ncontract AccessControlManager is AccessControl, IAccessControlManagerV8 {\n /// @notice Emitted when an account is given a permission to a certain contract function\n /// @dev If contract address is 0x000..0 this means that the account is a default admin of this function and\n /// can call any contract function with this signature\n event PermissionGranted(address account, address contractAddress, string functionSig);\n\n /// @notice Emitted when an account is revoked a permission to a certain contract function\n event PermissionRevoked(address account, address contractAddress, string functionSig);\n\n constructor() {\n // Grant the contract deployer the default admin role: it will be able\n // to grant and revoke any roles\n _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);\n }\n\n /**\n * @notice Gives a function call permission to one single account\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * @param contractAddress address of contract for which call permissions will be granted\n * @dev if contractAddress is zero address, the account can access the specified function\n * on **any** contract managed by this ACL\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @param accountToPermit account that will be given access to the contract function\n * @custom:event Emits a {RoleGranted} and {PermissionGranted} events.\n */\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n grantRole(role, accountToPermit);\n emit PermissionGranted(accountToPermit, contractAddress, functionSig);\n }\n\n /**\n * @notice Revokes an account's permission to a particular function call\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * \t\tMay emit a {RoleRevoked} event.\n * @param contractAddress address of contract for which call permissions will be revoked\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @custom:event Emits {RoleRevoked} and {PermissionRevoked} events.\n */\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n revokeRole(role, accountToRevoke);\n emit PermissionRevoked(accountToRevoke, contractAddress, functionSig);\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev Since restricted contracts using this function as a permission hook, we can get contracts address with msg.sender\n * @param account for which call permissions will be checked\n * @param functionSig restricted function signature e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n *\n */\n function isAllowedToCall(address account, string calldata functionSig) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(msg.sender, functionSig));\n\n if (hasRole(role, account)) {\n return true;\n } else {\n role = keccak256(abi.encodePacked(address(0), functionSig));\n return hasRole(role, account);\n }\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev This function is used as a view function to check permissions rather than contract hook for access restriction check.\n * @param account for which call permissions will be checked against\n * @param contractAddress address of the restricted contract\n * @param functionSig signature of the restricted function e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n */\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n return hasRole(role, account);\n }\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlManager\n * @author Venus\n * @dev This contract is a wrapper of OpenZeppelin AccessControl extending it in a way to standartize access control within Venus Smart Contract Ecosystem.\n * @notice Access control plays a crucial role in the Venus governance model. It is used to restrict functions so that they can only be called from one\n * account or list of accounts (EOA or Contract Accounts).\n *\n * The implementation of `AccessControlManager`(https://github.com/VenusProtocol/governance-contracts/blob/main/contracts/Governance/AccessControlManager.sol)\n * inherits the [Open Zeppelin AccessControl](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/AccessControl.sol)\n * contract as a base for role management logic. There are two role types: admin and granular permissions.\n * \n * ## Granular Roles\n * \n * Granular roles are built by hashing the contract address and its function signature. For example, given contract `Foo` with function `Foo.bar()` which\n * is guarded by ACM, calling `giveRolePermission` for account B do the following:\n * \n * 1. Compute `keccak256(contractFooAddress,functionSignatureBar)`\n * 1. Add the computed role to the roles of account B\n * 1. Account B now can call `ContractFoo.bar()`\n * \n * ## Admin Roles\n * \n * Admin roles allow for an address to call a function signature on any contract guarded by the `AccessControlManager`. This is particularly useful for\n * contracts created by factories.\n * \n * For Admin roles a null address is hashed in place of the contract address (`keccak256(0x0000000000000000000000000000000000000000,functionSignatureBar)`.\n * \n * In the previous example, giving account B the admin role, account B will have permissions to call the `bar()` function on any contract that is guarded by\n * ACM, not only contract A.\n * \n * ## Protocol Integration\n * \n * All restricted functions in Venus Protocol use a hook to ACM in order to check if the caller has the right permission to call the guarded function.\n * `AccessControlledV5` and `AccessControlledV8` abstract contract makes this integration easier. They call ACM's external method\n * `isAllowedToCall(address caller, string functionSig)`. Here is an example of how `setCollateralFactor` function in `Comptroller` is integrated with ACM:\n\n```\n contract Comptroller is [...] AccessControlledV8 {\n [...]\n function setCollateralFactor(VToken vToken, uint256 newCollateralFactorMantissa, uint256 newLiquidationThresholdMantissa) external {\n _checkAccessAllowed(\"setCollateralFactor(address,uint256,uint256)\");\n [...]\n }\n }\n```\n */\ncontract AccessControlManager is AccessControl, IAccessControlManagerV8 {\n /// @notice Emitted when an account is given a permission to a certain contract function\n /// @dev If contract address is 0x000..0 this means that the account is a default admin of this function and\n /// can call any contract function with this signature\n event PermissionGranted(address account, address contractAddress, string functionSig);\n\n /// @notice Emitted when an account is revoked a permission to a certain contract function\n event PermissionRevoked(address account, address contractAddress, string functionSig);\n\n constructor() {\n // Grant the contract deployer the default admin role: it will be able\n // to grant and revoke any roles\n _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);\n }\n\n /**\n * @notice Gives a function call permission to one single account\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * @param contractAddress address of contract for which call permissions will be granted\n * @dev if contractAddress is zero address, the account can access the specified function\n * on **any** contract managed by this ACL\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @param accountToPermit account that will be given access to the contract function\n * @custom:event Emits a {RoleGranted} and {PermissionGranted} events.\n */\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n grantRole(role, accountToPermit);\n emit PermissionGranted(accountToPermit, contractAddress, functionSig);\n }\n\n /**\n * @notice Revokes an account's permission to a particular function call\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * \t\tMay emit a {RoleRevoked} event.\n * @param contractAddress address of contract for which call permissions will be revoked\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @custom:event Emits {RoleRevoked} and {PermissionRevoked} events.\n */\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n revokeRole(role, accountToRevoke);\n emit PermissionRevoked(accountToRevoke, contractAddress, functionSig);\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev Since restricted contracts using this function as a permission hook, we can get contracts address with msg.sender\n * @param account for which call permissions will be checked\n * @param functionSig restricted function signature e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n *\n */\n function isAllowedToCall(address account, string calldata functionSig) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(msg.sender, functionSig));\n\n if (hasRole(role, account)) {\n return true;\n } else {\n role = keccak256(abi.encodePacked(address(0), functionSig));\n return hasRole(role, account);\n }\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev This function is used as a view function to check permissions rather than contract hook for access restriction check.\n * @param account for which call permissions will be checked against\n * @param contractAddress address of the restricted contract\n * @param functionSig signature of the restricted function e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n */\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n return hasRole(role, account);\n }\n}\n" }, "@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport \"@openzeppelin/contracts/access/IAccessControl.sol\";\n\n/**\n * @title IAccessControlManagerV8\n * @author Venus\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\n */\ninterface IAccessControlManagerV8 is IAccessControl {\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\n\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) external;\n\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\n\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) external view returns (bool);\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\nimport \"@openzeppelin/contracts/access/IAccessControl.sol\";\n\n/**\n * @title IAccessControlManagerV8\n * @author Venus\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\n */\ninterface IAccessControlManagerV8 is IAccessControl {\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\n\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) external;\n\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\n\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) external view returns (bool);\n}\n" }, "@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\ninterface OracleInterface {\n function getPrice(address asset) external view returns (uint256);\n}\n\ninterface ResilientOracleInterface is OracleInterface {\n function updatePrice(address vToken) external;\n\n function updateAssetPrice(address asset) external;\n\n function getUnderlyingPrice(address vToken) external view returns (uint256);\n}\n\ninterface TwapInterface is OracleInterface {\n function updateTwap(address asset) external returns (uint256);\n}\n\ninterface BoundValidatorInterface {\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool);\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface OracleInterface {\n function getPrice(address asset) external view returns (uint256);\n}\n\ninterface ResilientOracleInterface is OracleInterface {\n function updatePrice(address vToken) external;\n\n function updateAssetPrice(address asset) external;\n\n function getUnderlyingPrice(address vToken) external view returns (uint256);\n}\n\ninterface TwapInterface is OracleInterface {\n function updateTwap(address asset) external returns (uint256);\n}\n\ninterface BoundValidatorInterface {\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool);\n}\n" }, "@venusprotocol/solidity-utilities/contracts/constants.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\nuint256 constant EXP_SCALE = 1e18;\n\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\nuint256 constant MANTISSA_ONE = EXP_SCALE;\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\nuint256 constant EXP_SCALE = 1e18;\n\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\nuint256 constant MANTISSA_ONE = EXP_SCALE;\n\n/// @dev The approximate number of seconds per year\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\n" }, "@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \"./constants.sol\";\n\n/**\n * @title Exponential module for storing fixed-precision decimals\n * @author Compound\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\n * `Exp({mantissa: 5100000000000000000})`.\n */\ncontract ExponentialNoError {\n struct Exp {\n uint256 mantissa;\n }\n\n struct Double {\n uint256 mantissa;\n }\n\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\n uint256 internal constant DOUBLE_SCALE = 1e36;\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\n\n /**\n * @dev Truncates the given exp to a whole number value.\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\n */\n function truncate(Exp memory exp) internal pure returns (uint256) {\n // Note: We are not using careful math here as we're performing a division that cannot fail\n return exp.mantissa / EXP_SCALE;\n }\n\n /**\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return truncate(product);\n }\n\n /**\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return add_(truncate(product), addend);\n }\n\n /**\n * @dev Checks if first Exp is less than second Exp.\n */\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\n return left.mantissa < right.mantissa;\n }\n\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\n require(n <= type(uint224).max, errorMessage);\n return uint224(n);\n }\n\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\n require(n <= type(uint32).max, errorMessage);\n return uint32(n);\n }\n\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a + b;\n }\n\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a - b;\n }\n\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\n }\n\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / EXP_SCALE;\n }\n\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\n }\n\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\n }\n\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a * b;\n }\n\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\n }\n\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return div_(mul_(a, EXP_SCALE), b.mantissa);\n }\n\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\n }\n\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\n }\n\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a / b;\n }\n\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\n }\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { EXP_SCALE as EXP_SCALE_, MANTISSA_ONE as MANTISSA_ONE_ } from \"./constants.sol\";\n\n/**\n * @title Exponential module for storing fixed-precision decimals\n * @author Compound\n * @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.\n * Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:\n * `Exp({mantissa: 5100000000000000000})`.\n */\ncontract ExponentialNoError {\n struct Exp {\n uint256 mantissa;\n }\n\n struct Double {\n uint256 mantissa;\n }\n\n uint256 internal constant EXP_SCALE = EXP_SCALE_;\n uint256 internal constant DOUBLE_SCALE = 1e36;\n uint256 internal constant HALF_EXP_SCALE = EXP_SCALE / 2;\n uint256 internal constant MANTISSA_ONE = MANTISSA_ONE_;\n\n /**\n * @dev Truncates the given exp to a whole number value.\n * For example, truncate(Exp{mantissa: 15 * EXP_SCALE}) = 15\n */\n function truncate(Exp memory exp) internal pure returns (uint256) {\n // Note: We are not using careful math here as we're performing a division that cannot fail\n return exp.mantissa / EXP_SCALE;\n }\n\n /**\n * @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncate(Exp memory a, uint256 scalar) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return truncate(product);\n }\n\n /**\n * @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.\n */\n // solhint-disable-next-line func-name-mixedcase\n function mul_ScalarTruncateAddUInt(Exp memory a, uint256 scalar, uint256 addend) internal pure returns (uint256) {\n Exp memory product = mul_(a, scalar);\n return add_(truncate(product), addend);\n }\n\n /**\n * @dev Checks if first Exp is less than second Exp.\n */\n function lessThanExp(Exp memory left, Exp memory right) internal pure returns (bool) {\n return left.mantissa < right.mantissa;\n }\n\n function safe224(uint256 n, string memory errorMessage) internal pure returns (uint224) {\n require(n <= type(uint224).max, errorMessage);\n return uint224(n);\n }\n\n function safe32(uint256 n, string memory errorMessage) internal pure returns (uint32) {\n require(n <= type(uint32).max, errorMessage);\n return uint32(n);\n }\n\n function add_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: add_(a.mantissa, b.mantissa) });\n }\n\n function add_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a + b;\n }\n\n function sub_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: sub_(a.mantissa, b.mantissa) });\n }\n\n function sub_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a - b;\n }\n\n function mul_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b.mantissa) / EXP_SCALE });\n }\n\n function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / EXP_SCALE;\n }\n\n function mul_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b.mantissa) / DOUBLE_SCALE });\n }\n\n function mul_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: mul_(a.mantissa, b) });\n }\n\n function mul_(uint256 a, Double memory b) internal pure returns (uint256) {\n return mul_(a, b.mantissa) / DOUBLE_SCALE;\n }\n\n function mul_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a * b;\n }\n\n function div_(Exp memory a, Exp memory b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(mul_(a.mantissa, EXP_SCALE), b.mantissa) });\n }\n\n function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {\n return Exp({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Exp memory b) internal pure returns (uint256) {\n return div_(mul_(a, EXP_SCALE), b.mantissa);\n }\n\n function div_(Double memory a, Double memory b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a.mantissa, DOUBLE_SCALE), b.mantissa) });\n }\n\n function div_(Double memory a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(a.mantissa, b) });\n }\n\n function div_(uint256 a, Double memory b) internal pure returns (uint256) {\n return div_(mul_(a, DOUBLE_SCALE), b.mantissa);\n }\n\n function div_(uint256 a, uint256 b) internal pure returns (uint256) {\n return a / b;\n }\n\n function fraction(uint256 a, uint256 b) internal pure returns (Double memory) {\n return Double({ mantissa: div_(mul_(a, DOUBLE_SCALE), b) });\n }\n}\n" }, "@venusprotocol/solidity-utilities/contracts/validators.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\nerror ZeroAddressNotAllowed();\n\n/// @notice Checks if the provided address is nonzero, reverts otherwise\n/// @param address_ Address to check\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\nfunction ensureNonzeroAddress(address address_) pure {\n if (address_ == address(0)) {\n revert ZeroAddressNotAllowed();\n }\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\nerror ZeroAddressNotAllowed();\n\n/// @notice Thrown if the supplied value is 0 where it is not allowed\nerror ZeroValueNotAllowed();\n\n/// @notice Checks if the provided address is nonzero, reverts otherwise\n/// @param address_ Address to check\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\nfunction ensureNonzeroAddress(address address_) pure {\n if (address_ == address(0)) {\n revert ZeroAddressNotAllowed();\n }\n}\n\n/// @notice Checks if the provided value is nonzero, reverts otherwise\n/// @param value_ Value to check\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\nfunction ensureNonzeroValue(uint256 value_) pure {\n if (value_ == 0) {\n revert ZeroValueNotAllowed();\n }\n}\n" }, "contracts/Bridge/BaseXVSProxyOFT.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ResilientOracleInterface } from \"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { BaseOFTV2 } from \"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { ExponentialNoError } from \"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\";\n\n/**\n * @title BaseXVSProxyOFT\n * @author Venus\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\n * It manages transaction limits of a single and daily transactions.\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\n */\n\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\n using SafeERC20 for IERC20;\n IERC20 internal immutable innerToken;\n uint256 internal immutable ld2sdRate;\n bool public sendAndCallEnabled;\n\n /**\n * @notice The address of ResilientOracle contract wrapped in its interface.\n */\n ResilientOracleInterface public oracle;\n /**\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\n /**\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\n /**\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\n /**\n * @notice Timestamp when the last 24-hour window started from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\n /**\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\n /**\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\n /**\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\n /**\n * @notice Timestamp when the last 24-hour window started from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\n /**\n * @notice Address on which cap check and bound limit is not applicable.\n */\n mapping(address => bool) public whitelist;\n\n /**\n * @notice Emitted when address is added to whitelist.\n */\n event SetWhitelist(address indexed addr, bool isWhitelist);\n /**\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\n */\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\n */\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\n */\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\n */\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Event emitted when oracle is modified.\n */\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\n /**\n * @notice Event emitted when trusted remote sets to empty.\n */\n event TrustedRemoteRemoved(uint16 chainId);\n /**\n * @notice Event emitted when inner token set successfully.\n */\n event InnerTokenAdded(address indexed innerToken);\n /**\n *@notice Emitted on sweep token success\n */\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\n /**\n * @notice Event emitted when SendAndCallEnabled updated successfully.\n */\n event UpdateSendAndCallEnabled(bool indexed enabled);\n /**\n *@notice Error thrown when this contract balance is less than sweep amount\n */\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\n\n /**\n * @param tokenAddress_ Address of the inner token.\n * @param sharedDecimals_ Number of shared decimals.\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\n * @param oracle_ Address of the price oracle.\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\n * @custom:event Emits InnerTokenAdded with token address.\n * @custom:event Emits OracleChanged with zero address and oracle address.\n */\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\n ensureNonzeroAddress(tokenAddress_);\n ensureNonzeroAddress(lzEndpoint_);\n ensureNonzeroAddress(oracle_);\n\n innerToken = IERC20(tokenAddress_);\n\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\"decimals()\"));\n require(success, \"ProxyOFT: failed to get token decimals\");\n uint8 decimals = abi.decode(data, (uint8));\n\n require(sharedDecimals_ <= decimals, \"ProxyOFT: sharedDecimals must be <= decimals\");\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\n\n emit InnerTokenAdded(tokenAddress_);\n emit OracleChanged(address(0), oracle_);\n\n oracle = ResilientOracleInterface(oracle_);\n }\n\n /**\n * @notice Set the address of the ResilientOracle contract.\n * @dev Reverts if the new address is zero.\n * @param oracleAddress_ The new address of the ResilientOracle contract.\n * @custom:access Only owner.\n * @custom:event Emits OracleChanged with old and new oracle address.\n */\n function setOracle(address oracleAddress_) external onlyOwner {\n ensureNonzeroAddress(oracleAddress_);\n emit OracleChanged(address(oracle), oracleAddress_);\n oracle = ResilientOracleInterface(oracleAddress_);\n }\n\n /**\n * @notice Sets the limit of single transaction amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \"Single transaction limit > Daily limit\");\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the limit of daily (24 Hour) transactions amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\n */\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \"Daily limit < single transaction limit\");\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\n chainIdToMaxDailyLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum limit for a single receive transaction.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \"single receive transaction limit > Daily limit\");\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum daily limit for receiving transactions.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\n */\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\n \"Daily limit < single receive transaction limit\"\n );\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the whitelist address to skip checks on transaction limit.\n * @param user_ Address to be add in whitelist.\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\n * @custom:access Only owner.\n * @custom:event Emits setWhitelist.\n */\n function setWhitelist(address user_, bool val_) external onlyOwner {\n emit SetWhitelist(user_, val_);\n whitelist[user_] = val_;\n }\n\n /**\n * @notice Triggers stopped state of the bridge.\n * @custom:access Only owner.\n */\n function pause() external onlyOwner {\n _pause();\n }\n\n /**\n * @notice Triggers resume state of the bridge.\n * @custom:access Only owner.\n */\n function unpause() external onlyOwner {\n _unpause();\n }\n\n /**\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\n * @param token_ The address of the ERC-20 token to sweep\n * @param to_ The address of the recipient\n * @param amount_ The amount of tokens needs to transfer\n * @custom:event Emits SweepToken event\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\n * @custom:access Only Owner\n */\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\n uint256 balance = token_.balanceOf(address(this));\n if (amount_ > balance) {\n revert InsufficientBalance(amount_, balance);\n }\n\n emit SweepToken(address(token_), to_, amount_);\n\n token_.safeTransfer(to_, amount_);\n }\n\n /**\n * @notice Remove trusted remote from storage.\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\n * @custom:access Only owner.\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\n */\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\n delete trustedRemoteLookup[remoteChainId_];\n emit TrustedRemoteRemoved(remoteChainId_);\n }\n\n /**\n * @notice It enables or disables sendAndCall functionality for the bridge.\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\n */\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\n sendAndCallEnabled = enabled_;\n emit UpdateSendAndCallEnabled(enabled_);\n }\n\n /**\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\n * @param from_ The sender's address initiating the transfer.\n * @param dstChainId_ Indicates destination chain.\n * @param amount_ The quantity of tokens to be transferred.\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\n * @return maxDailyLimit The maximum daily limit for transactions.\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\n */\n function isEligibleToSend(\n address from_,\n uint16 dstChainId_,\n uint256 amount_\n )\n external\n view\n returns (\n bool eligibleToSend,\n uint256 maxSingleTransactionLimit,\n uint256 maxDailyLimit,\n uint256 amountInUsd,\n uint256 transferredInWindow,\n uint256 last24HourWindowStart,\n bool isWhiteListedUser\n )\n {\n // Check if the sender's address is whitelisted\n isWhiteListedUser = whitelist[from_];\n\n // Calculate the amount in USD using the oracle price\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n last24HourWindowStart = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n eligibleToSend = (isWhiteListedUser ||\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\n }\n\n /**\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\n * @param from_ Address from which tokens will be debited.\n * @param dstChainId_ Destination chain id on which tokens will be send.\n * @param toAddress_ Address on which tokens will be credited on destination chain.\n * @param amount_ Amount of tokens that will be transferred.\n * @param payload_ Additional data payload for the call on the destination chain.\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\n * and adapter params.\n */\n function sendAndCall(\n address from_,\n uint16 dstChainId_,\n bytes32 toAddress_,\n uint256 amount_,\n bytes calldata payload_,\n uint64 dstGasForCall_,\n LzCallParams calldata callparams_\n ) public payable override {\n require(sendAndCallEnabled, \"sendAndCall is disabled\");\n\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\n }\n\n function retryMessage(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public payable override {\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\n require(\n _srcAddress.length == trustedRemote.length &&\n trustedRemote.length > 0 &&\n keccak256(_srcAddress) == keccak256(trustedRemote),\n \"LzApp: invalid source sending contract\"\n );\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @notice Return's the address of the inner token of this bridge.\n * @return Address of the inner token of this bridge.\n */\n function token() public view override returns (address) {\n return address(innerToken);\n }\n\n /**\n * @notice Checks if the sender is eligible to send tokens\n * @param from_ Sender's address sending tokens\n * @param dstChainId_ Chain id on which tokens should be sent\n * @param amount_ Amount of tokens to be sent\n */\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\n // Check if the sender's address is whitelisted\n bool isWhiteListedUser = whitelist[from_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the amount in USD using the oracle price\n uint256 amountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n\n // Revert if the amount exceeds the single transaction limit\n require(amountInUsd <= maxSingleTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n\n // Revert if the amount exceeds the daily limit\n require(transferredInWindow <= maxDailyLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the amount for the 24-hour window\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\n }\n\n /**\n * @notice Checks if receiver is able to receive tokens\n * @param toAddress_ Receiver address\n * @param srcChainId_ Source chain id from which token is send\n * @param receivedAmount_ Amount of tokens received\n */\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\n // Check if the recipient's address is whitelisted\n bool isWhiteListedUser = whitelist[toAddress_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the received amount in USD using the oracle price\n uint256 receivedAmountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\n\n uint256 currentBlockTimestamp = block.timestamp;\n\n // Load values for the 24-hour window checks for receiving\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\n\n // Check if the received amount exceeds the single transaction limit\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\n receivedInWindow = receivedAmountInUsd;\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\n } else {\n receivedInWindow += receivedAmountInUsd;\n }\n\n // Revert if the received amount exceeds the daily limit\n require(receivedInWindow <= maxDailyReceiveLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the received amount for the 24-hour window\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\n }\n\n /**\n * @notice Transfer tokens from sender to receiver account.\n * @param from_ Address from which token has to be transferred(Sender).\n * @param to_ Address on which token will be tranferred(Receiver).\n * @param amount_ Amount of token to be transferred.\n * @return Actual balance difference.\n */\n function _transferFrom(\n address from_,\n address to_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n uint256 before = innerToken.balanceOf(to_);\n if (from_ == address(this)) {\n innerToken.safeTransfer(to_, amount_);\n } else {\n innerToken.safeTransferFrom(from_, to_, amount_);\n }\n return innerToken.balanceOf(to_) - before;\n }\n\n /**\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\n * @return Conversion rate factor.\n */\n function _ld2sdRate() internal view override returns (uint256) {\n return ld2sdRate;\n }\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ResilientOracleInterface } from \"@venusprotocol/oracle/contracts/interfaces/OracleInterface.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { BaseOFTV2 } from \"@layerzerolabs/solidity-examples/contracts/token/oft/v2/BaseOFTV2.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { ExponentialNoError } from \"@venusprotocol/solidity-utilities/contracts/ExponentialNoError.sol\";\n\n/**\n * @title BaseXVSProxyOFT\n * @author Venus\n * @notice The BaseXVSProxyOFT contract is tailored for facilitating cross-chain transactions with an ERC20 token.\n * It manages transaction limits of a single and daily transactions.\n * This contract inherits key functionalities from other contracts, including pausing capabilities and error handling.\n * It holds state variables for the inner token and maps for tracking transaction limits and statistics across various chains and addresses.\n * The contract allows the owner to configure limits, set whitelists, and control pausing.\n * Internal functions conduct eligibility check of transactions, making the contract a fundamental component for cross-chain token management.\n */\n\nabstract contract BaseXVSProxyOFT is Pausable, ExponentialNoError, BaseOFTV2 {\n using SafeERC20 for IERC20;\n IERC20 internal immutable innerToken;\n uint256 internal immutable ld2sdRate;\n bool public sendAndCallEnabled;\n\n /**\n * @notice The address of ResilientOracle contract wrapped in its interface.\n */\n ResilientOracleInterface public oracle;\n /**\n * @notice Maximum limit for a single transaction in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleTransactionLimit;\n /**\n * @notice Maximum daily limit for transactions in USD(scaled with 18 decimals) from local chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyLimit;\n /**\n * @notice Total sent amount in USD(scaled with 18 decimals) within the last 24-hour window from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourTransferred;\n /**\n * @notice Timestamp when the last 24-hour window started from local chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourWindowStart;\n /**\n * @notice Maximum limit for a single receive transaction in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxSingleReceiveTransactionLimit;\n /**\n * @notice Maximum daily limit for receiving transactions in USD(scaled with 18 decimals) from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToMaxDailyReceiveLimit;\n /**\n * @notice Total received amount in USD(scaled with 18 decimals) within the last 24-hour window from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceived;\n /**\n * @notice Timestamp when the last 24-hour window started from remote chain.\n */\n mapping(uint16 => uint256) public chainIdToLast24HourReceiveWindowStart;\n /**\n * @notice Address on which cap check and bound limit is not applicable.\n */\n mapping(address => bool) public whitelist;\n\n /**\n * @notice Emitted when address is added to whitelist.\n */\n event SetWhitelist(address indexed addr, bool isWhitelist);\n /**\n * @notice Emitted when the maximum limit for a single transaction from local chain is modified.\n */\n event SetMaxSingleTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit of transactions from local chain is modified.\n */\n event SetMaxDailyLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum limit for a single receive transaction from remote chain is modified.\n */\n event SetMaxSingleReceiveTransactionLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Emitted when the maximum daily limit for receiving transactions from remote chain is modified.\n */\n event SetMaxDailyReceiveLimit(uint16 chainId, uint256 oldMaxLimit, uint256 newMaxLimit);\n /**\n * @notice Event emitted when oracle is modified.\n */\n event OracleChanged(address indexed oldOracle, address indexed newOracle);\n /**\n * @notice Event emitted when trusted remote sets to empty.\n */\n event TrustedRemoteRemoved(uint16 chainId);\n /**\n * @notice Event emitted when inner token set successfully.\n */\n event InnerTokenAdded(address indexed innerToken);\n /**\n *@notice Emitted on sweep token success\n */\n event SweepToken(address indexed token, address indexed to, uint256 sweepAmount);\n /**\n * @notice Event emitted when SendAndCallEnabled updated successfully.\n */\n event UpdateSendAndCallEnabled(bool indexed enabled);\n /**\n *@notice Error thrown when this contract balance is less than sweep amount\n */\n error InsufficientBalance(uint256 sweepAmount, uint256 balance);\n\n /**\n * @param tokenAddress_ Address of the inner token.\n * @param sharedDecimals_ Number of shared decimals.\n * @param lzEndpoint_ Address of the layer zero endpoint contract.\n * @param oracle_ Address of the price oracle.\n * @custom:error ZeroAddressNotAllowed is thrown when token contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when lzEndpoint contract address is zero.\n * @custom:error ZeroAddressNotAllowed is thrown when oracle contract address is zero.\n * @custom:event Emits InnerTokenAdded with token address.\n * @custom:event Emits OracleChanged with zero address and oracle address.\n */\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseOFTV2(sharedDecimals_, lzEndpoint_) {\n ensureNonzeroAddress(tokenAddress_);\n ensureNonzeroAddress(lzEndpoint_);\n ensureNonzeroAddress(oracle_);\n\n innerToken = IERC20(tokenAddress_);\n\n (bool success, bytes memory data) = tokenAddress_.staticcall(abi.encodeWithSignature(\"decimals()\"));\n require(success, \"ProxyOFT: failed to get token decimals\");\n uint8 decimals = abi.decode(data, (uint8));\n\n require(sharedDecimals_ <= decimals, \"ProxyOFT: sharedDecimals must be <= decimals\");\n ld2sdRate = 10 ** (decimals - sharedDecimals_);\n\n emit InnerTokenAdded(tokenAddress_);\n emit OracleChanged(address(0), oracle_);\n\n oracle = ResilientOracleInterface(oracle_);\n }\n\n /**\n * @notice Set the address of the ResilientOracle contract.\n * @dev Reverts if the new address is zero.\n * @param oracleAddress_ The new address of the ResilientOracle contract.\n * @custom:access Only owner.\n * @custom:event Emits OracleChanged with old and new oracle address.\n */\n function setOracle(address oracleAddress_) external onlyOwner {\n ensureNonzeroAddress(oracleAddress_);\n emit OracleChanged(address(oracle), oracleAddress_);\n oracle = ResilientOracleInterface(oracleAddress_);\n }\n\n /**\n * @notice Sets the limit of single transaction amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits SetMaxSingleTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyLimit[chainId_], \"Single transaction limit > Daily limit\");\n emit SetMaxSingleTransactionLimit(chainId_, chainIdToMaxSingleTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the limit of daily (24 Hour) transactions amount.\n * @param chainId_ Destination chain id.\n * @param limit_ Amount in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyLimit with old and new limit associated with chain id.\n */\n function setMaxDailyLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ >= chainIdToMaxSingleTransactionLimit[chainId_], \"Daily limit < single transaction limit\");\n emit SetMaxDailyLimit(chainId_, chainIdToMaxDailyLimit[chainId_], limit_);\n chainIdToMaxDailyLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum limit for a single receive transaction.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxSingleReceiveTransactionLimit with old and new limit associated with chain id.\n */\n function setMaxSingleReceiveTransactionLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(limit_ <= chainIdToMaxDailyReceiveLimit[chainId_], \"single receive transaction limit > Daily limit\");\n emit SetMaxSingleReceiveTransactionLimit(chainId_, chainIdToMaxSingleReceiveTransactionLimit[chainId_], limit_);\n chainIdToMaxSingleReceiveTransactionLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the maximum daily limit for receiving transactions.\n * @param chainId_ The destination chain ID.\n * @param limit_ The new maximum daily limit in USD(scaled with 18 decimals).\n * @custom:access Only owner.\n * @custom:event Emits setMaxDailyReceiveLimit with old and new limit associated with chain id.\n */\n function setMaxDailyReceiveLimit(uint16 chainId_, uint256 limit_) external onlyOwner {\n require(\n limit_ >= chainIdToMaxSingleReceiveTransactionLimit[chainId_],\n \"Daily limit < single receive transaction limit\"\n );\n emit SetMaxDailyReceiveLimit(chainId_, chainIdToMaxDailyReceiveLimit[chainId_], limit_);\n chainIdToMaxDailyReceiveLimit[chainId_] = limit_;\n }\n\n /**\n * @notice Sets the whitelist address to skip checks on transaction limit.\n * @param user_ Address to be add in whitelist.\n * @param val_ Boolean to be set (true for user_ address is whitelisted).\n * @custom:access Only owner.\n * @custom:event Emits setWhitelist.\n */\n function setWhitelist(address user_, bool val_) external onlyOwner {\n emit SetWhitelist(user_, val_);\n whitelist[user_] = val_;\n }\n\n /**\n * @notice Triggers stopped state of the bridge.\n * @custom:access Only owner.\n */\n function pause() external onlyOwner {\n _pause();\n }\n\n /**\n * @notice Triggers resume state of the bridge.\n * @custom:access Only owner.\n */\n function unpause() external onlyOwner {\n _unpause();\n }\n\n /**\n * @notice A public function to sweep accidental ERC-20 transfers to this contract. Tokens are sent to user\n * @param token_ The address of the ERC-20 token to sweep\n * @param to_ The address of the recipient\n * @param amount_ The amount of tokens needs to transfer\n * @custom:event Emits SweepToken event\n * @custom:error Throw InsufficientBalance if amount_ is greater than the available balance of the token in the contract\n * @custom:access Only Owner\n */\n function sweepToken(IERC20 token_, address to_, uint256 amount_) external onlyOwner {\n uint256 balance = token_.balanceOf(address(this));\n if (amount_ > balance) {\n revert InsufficientBalance(amount_, balance);\n }\n\n emit SweepToken(address(token_), to_, amount_);\n\n token_.safeTransfer(to_, amount_);\n }\n\n /**\n * @notice Remove trusted remote from storage.\n * @param remoteChainId_ The chain's id corresponds to setting the trusted remote to empty.\n * @custom:access Only owner.\n * @custom:event Emits TrustedRemoteRemoved once chain id is removed from trusted remote.\n */\n function removeTrustedRemote(uint16 remoteChainId_) external onlyOwner {\n delete trustedRemoteLookup[remoteChainId_];\n emit TrustedRemoteRemoved(remoteChainId_);\n }\n\n /**\n * @notice It enables or disables sendAndCall functionality for the bridge.\n * @param enabled_ Boolean indicating whether the sendAndCall function should be enabled or disabled.\n */\n function updateSendAndCallEnabled(bool enabled_) external onlyOwner {\n sendAndCallEnabled = enabled_;\n emit UpdateSendAndCallEnabled(enabled_);\n }\n\n /**\n * @notice Checks the eligibility of a sender to initiate a cross-chain token transfer.\n * @dev This external view function assesses whether the specified sender is eligible to transfer the given amount\n * to the specified destination chain. It considers factors such as whitelisting, transaction limits, and a 24-hour window.\n * @param from_ The sender's address initiating the transfer.\n * @param dstChainId_ Indicates destination chain.\n * @param amount_ The quantity of tokens to be transferred.\n * @return eligibleToSend A boolean indicating whether the sender is eligible to transfer the tokens.\n * @return maxSingleTransactionLimit The maximum limit for a single transaction.\n * @return maxDailyLimit The maximum daily limit for transactions.\n * @return amountInUsd The equivalent amount in USD based on the oracle price.\n * @return transferredInWindow The total amount transferred in the current 24-hour window.\n * @return last24HourWindowStart The timestamp when the current 24-hour window started.\n * @return isWhiteListedUser A boolean indicating whether the sender is whitelisted.\n */\n function isEligibleToSend(\n address from_,\n uint16 dstChainId_,\n uint256 amount_\n )\n external\n view\n returns (\n bool eligibleToSend,\n uint256 maxSingleTransactionLimit,\n uint256 maxDailyLimit,\n uint256 amountInUsd,\n uint256 transferredInWindow,\n uint256 last24HourWindowStart,\n bool isWhiteListedUser\n )\n {\n // Check if the sender's address is whitelisted\n isWhiteListedUser = whitelist[from_];\n\n // Calculate the amount in USD using the oracle price\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n last24HourWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n if (currentBlockTimestamp - last24HourWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n last24HourWindowStart = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n eligibleToSend = (isWhiteListedUser ||\n ((amountInUsd <= maxSingleTransactionLimit) && (transferredInWindow <= maxDailyLimit)));\n }\n\n /**\n * @notice Initiates a cross-chain token transfer and triggers a call on the destination chain.\n * @dev This internal override function enables the contract to send tokens and invoke calls on the specified\n * destination chain. It checks whether the sendAndCall feature is enabled before proceeding with the transfer.\n * @param from_ Address from which tokens will be debited.\n * @param dstChainId_ Destination chain id on which tokens will be send.\n * @param toAddress_ Address on which tokens will be credited on destination chain.\n * @param amount_ Amount of tokens that will be transferred.\n * @param payload_ Additional data payload for the call on the destination chain.\n * @param dstGasForCall_ The amount of gas allocated for the call on the destination chain.\n * @param callparams_ Additional parameters, including refund address, ZRO payment address,\n * and adapter params.\n */\n function sendAndCall(\n address from_,\n uint16 dstChainId_,\n bytes32 toAddress_,\n uint256 amount_,\n bytes calldata payload_,\n uint64 dstGasForCall_,\n LzCallParams calldata callparams_\n ) public payable override {\n require(sendAndCallEnabled, \"sendAndCall is disabled\");\n\n super.sendAndCall(from_, dstChainId_, toAddress_, amount_, payload_, dstGasForCall_, callparams_);\n }\n\n function retryMessage(\n uint16 _srcChainId,\n bytes calldata _srcAddress,\n uint64 _nonce,\n bytes calldata _payload\n ) public payable override {\n bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];\n // it will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.\n require(\n _srcAddress.length == trustedRemote.length &&\n trustedRemote.length > 0 &&\n keccak256(_srcAddress) == keccak256(trustedRemote),\n \"LzApp: invalid source sending contract\"\n );\n super.retryMessage(_srcChainId, _srcAddress, _nonce, _payload);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @notice Return's the address of the inner token of this bridge.\n * @return Address of the inner token of this bridge.\n */\n function token() public view override returns (address) {\n return address(innerToken);\n }\n\n /**\n * @notice Checks if the sender is eligible to send tokens\n * @param from_ Sender's address sending tokens\n * @param dstChainId_ Chain id on which tokens should be sent\n * @param amount_ Amount of tokens to be sent\n */\n function _isEligibleToSend(address from_, uint16 dstChainId_, uint256 amount_) internal {\n // Check if the sender's address is whitelisted\n bool isWhiteListedUser = whitelist[from_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the amount in USD using the oracle price\n uint256 amountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(token()) });\n amountInUsd = mul_ScalarTruncate(oraclePrice, amount_);\n\n // Load values for the 24-hour window checks\n uint256 currentBlockTimestamp = block.timestamp;\n uint256 lastDayWindowStart = chainIdToLast24HourWindowStart[dstChainId_];\n uint256 transferredInWindow = chainIdToLast24HourTransferred[dstChainId_];\n uint256 maxSingleTransactionLimit = chainIdToMaxSingleTransactionLimit[dstChainId_];\n uint256 maxDailyLimit = chainIdToMaxDailyLimit[dstChainId_];\n\n // Revert if the amount exceeds the single transaction limit\n require(amountInUsd <= maxSingleTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayWindowStart > 1 days) {\n transferredInWindow = amountInUsd;\n chainIdToLast24HourWindowStart[dstChainId_] = currentBlockTimestamp;\n } else {\n transferredInWindow += amountInUsd;\n }\n\n // Revert if the amount exceeds the daily limit\n require(transferredInWindow <= maxDailyLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the amount for the 24-hour window\n chainIdToLast24HourTransferred[dstChainId_] = transferredInWindow;\n }\n\n /**\n * @notice Checks if receiver is able to receive tokens\n * @param toAddress_ Receiver address\n * @param srcChainId_ Source chain id from which token is send\n * @param receivedAmount_ Amount of tokens received\n */\n function _isEligibleToReceive(address toAddress_, uint16 srcChainId_, uint256 receivedAmount_) internal {\n // Check if the recipient's address is whitelisted\n bool isWhiteListedUser = whitelist[toAddress_];\n // Check if the user is whitelisted and return if true\n if (isWhiteListedUser) {\n return;\n }\n\n // Calculate the received amount in USD using the oracle price\n uint256 receivedAmountInUsd;\n Exp memory oraclePrice = Exp({ mantissa: oracle.getPrice(address(token())) });\n receivedAmountInUsd = mul_ScalarTruncate(oraclePrice, receivedAmount_);\n\n uint256 currentBlockTimestamp = block.timestamp;\n\n // Load values for the 24-hour window checks for receiving\n uint256 lastDayReceiveWindowStart = chainIdToLast24HourReceiveWindowStart[srcChainId_];\n uint256 receivedInWindow = chainIdToLast24HourReceived[srcChainId_];\n uint256 maxSingleReceiveTransactionLimit = chainIdToMaxSingleReceiveTransactionLimit[srcChainId_];\n uint256 maxDailyReceiveLimit = chainIdToMaxDailyReceiveLimit[srcChainId_];\n\n // Check if the received amount exceeds the single transaction limit\n require(receivedAmountInUsd <= maxSingleReceiveTransactionLimit, \"Single Transaction Limit Exceed\");\n\n // Check if the time window has changed (more than 24 hours have passed)\n if (currentBlockTimestamp - lastDayReceiveWindowStart > 1 days) {\n receivedInWindow = receivedAmountInUsd;\n chainIdToLast24HourReceiveWindowStart[srcChainId_] = currentBlockTimestamp;\n } else {\n receivedInWindow += receivedAmountInUsd;\n }\n\n // Revert if the received amount exceeds the daily limit\n require(receivedInWindow <= maxDailyReceiveLimit, \"Daily Transaction Limit Exceed\");\n\n // Update the received amount for the 24-hour window\n chainIdToLast24HourReceived[srcChainId_] = receivedInWindow;\n }\n\n /**\n * @notice Transfer tokens from sender to receiver account.\n * @param from_ Address from which token has to be transferred(Sender).\n * @param to_ Address on which token will be tranferred(Receiver).\n * @param amount_ Amount of token to be transferred.\n * @return Actual balance difference.\n */\n function _transferFrom(\n address from_,\n address to_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n uint256 before = innerToken.balanceOf(to_);\n if (from_ == address(this)) {\n innerToken.safeTransfer(to_, amount_);\n } else {\n innerToken.safeTransferFrom(from_, to_, amount_);\n }\n return innerToken.balanceOf(to_) - before;\n }\n\n /**\n * @notice Returns Conversion rate factor from large decimals to shared decimals.\n * @return Conversion rate factor.\n */\n function _ld2sdRate() internal view override returns (uint256) {\n return ld2sdRate;\n }\n}\n" }, "contracts/Bridge/interfaces/IXVS.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/**\n * @title IXVS\n * @author Venus\n * @notice Interface implemented by `XVS` token.\n */\ninterface IXVS {\n function mint(address to, uint256 amount) external;\n\n function burn(address from, uint256 amount) external;\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/**\n * @title IXVS\n * @author Venus\n * @notice Interface implemented by `XVS` token.\n */\ninterface IXVS {\n function mint(address to, uint256 amount) external;\n\n function burn(address from, uint256 amount) external;\n}\n" }, "contracts/Bridge/interfaces/IXVSProxyOFT.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\n/**\n * @title IXVSProxyOFT\n * @author Venus\n * @notice Interface implemented by `XVSProxyOFT`.\n */\ninterface IXVSProxyOFT {\n function transferOwnership(address addr) external;\n\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\n\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/**\n * @title IXVSProxyOFT\n * @author Venus\n * @notice Interface implemented by `XVSProxyOFT`.\n */\ninterface IXVSProxyOFT {\n function transferOwnership(address addr) external;\n\n function setTrustedRemoteAddress(uint16 remoteChainId, bytes calldata srcAddress) external;\n\n function isTrustedRemote(uint16 remoteChainId, bytes calldata srcAddress) external returns (bool);\n}\n" }, "contracts/Bridge/token/TokenController.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\nimport { IAccessControlManagerV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { Ownable } from \"@openzeppelin/contracts/access/Ownable.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title TokenController\n * @author Venus\n * @notice TokenController contract acts as a governance and access control mechanism,\n * allowing the owner to manage minting restrictions and blacklist certain addresses to maintain control and security within the token ecosystem.\n * It provides a flexible framework for token-related operations.\n */\n\ncontract TokenController is Ownable, Pausable {\n /**\n * @notice Access control manager contract address.\n */\n address public accessControlManager;\n /**\n * @notice A Mapping used to keep track of the blacklist status of addresses.\n */\n mapping(address => bool) internal _blacklist;\n /**\n * @notice A mapping is used to keep track of the maximum amount a minter is permitted to mint.\n */\n mapping(address => uint256) public minterToCap;\n /**\n * @notice A Mapping used to keep track of the amount i.e already minted by minter.\n */\n mapping(address => uint256) public minterToMintedAmount;\n\n /**\n * @notice Emitted when the blacklist status of a user is updated.\n */\n event BlacklistUpdated(address indexed user, bool value);\n /**\n * @notice Emitted when the minting limit for a minter is increased.\n */\n event MintLimitIncreased(address indexed minter, uint256 newLimit);\n /**\n * @notice Emitted when the minting limit for a minter is decreased.\n */\n event MintLimitDecreased(address indexed minter, uint256 newLimit);\n /**\n * @notice Emitted when the minting cap for a minter is changed.\n */\n event MintCapChanged(address indexed minter, uint256 amount);\n /**\n * @notice Emitted when the address of the access control manager of the contract is updated.\n */\n event NewAccessControlManager(address indexed oldAccessControlManager, address indexed newAccessControlManager);\n /**\n * @notice Emitted when all minted tokens are migrated from one minter to another.\n */\n event MintedTokensMigrated(address indexed source, address indexed destination);\n\n /**\n * @notice This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\n */\n error MintLimitExceed();\n /**\n * @notice This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\n */\n error AccountBlacklisted(address user);\n /**\n * @notice This error is used to indicate that sender is not allowed to perform this action.\n */\n error Unauthorized();\n /**\n * @notice This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\n */\n error NewCapNotGreaterThanMintedTokens();\n /**\n * @notice This error is used to indicate that the addresses must be different.\n */\n error AddressesMustDiffer();\n /**\n * @notice This error is used to indicate that the minter did not mint the required amount of tokens.\n */\n error MintedAmountExceed();\n\n /**\n * @param accessControlManager_ Address of access control manager contract.\n * @custom:error ZeroAddressNotAllowed is thrown when accessControlManager contract address is zero.\n */\n constructor(address accessControlManager_) {\n ensureNonzeroAddress(accessControlManager_);\n accessControlManager = accessControlManager_;\n }\n\n /**\n * @notice Pauses Token\n * @custom:access Controlled by AccessControlManager.\n */\n function pause() external {\n _ensureAllowed(\"pause()\");\n _pause();\n }\n\n /**\n * @notice Resumes Token\n * @custom:access Controlled by AccessControlManager.\n */\n function unpause() external {\n _ensureAllowed(\"unpause()\");\n _unpause();\n }\n\n /**\n * @notice Function to update blacklist.\n * @param user_ User address to be affected.\n * @param value_ Boolean to toggle value.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits BlacklistUpdated event.\n */\n function updateBlacklist(address user_, bool value_) external {\n _ensureAllowed(\"updateBlacklist(address,bool)\");\n _blacklist[user_] = value_;\n emit BlacklistUpdated(user_, value_);\n }\n\n /**\n * @notice Sets the minting cap for minter.\n * @param minter_ Minter address.\n * @param amount_ Cap for the minter.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintCapChanged.\n */\n function setMintCap(address minter_, uint256 amount_) external {\n _ensureAllowed(\"setMintCap(address,uint256)\");\n\n if (amount_ < minterToMintedAmount[minter_]) {\n revert NewCapNotGreaterThanMintedTokens();\n }\n\n minterToCap[minter_] = amount_;\n emit MintCapChanged(minter_, amount_);\n }\n\n /**\n * @notice Sets the address of the access control manager of this contract.\n * @dev Admin function to set the access control address.\n * @param newAccessControlAddress_ New address for the access control.\n * @custom:access Only owner.\n * @custom:event Emits NewAccessControlManager.\n * @custom:error ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\n */\n function setAccessControlManager(address newAccessControlAddress_) external onlyOwner {\n ensureNonzeroAddress(newAccessControlAddress_);\n emit NewAccessControlManager(accessControlManager, newAccessControlAddress_);\n accessControlManager = newAccessControlAddress_;\n }\n\n /**\n * @notice Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\n * @param source_ Minter address to migrate tokens from.\n * @param destination_ Minter address to migrate tokens to.\n * @custom:access Controlled by AccessControlManager.\n * @custom:error MintLimitExceed is thrown when the minting limit exceeds the cap after migration.\n * @custom:error AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\n * @custom:event Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.\n * @custom:event Emits MintedTokensMigrated.\n */\n function migrateMinterTokens(address source_, address destination_) external {\n _ensureAllowed(\"migrateMinterTokens(address,address)\");\n\n if (source_ == destination_) {\n revert AddressesMustDiffer();\n }\n\n uint256 sourceCap = minterToCap[source_];\n uint256 destinationCap = minterToCap[destination_];\n\n uint256 sourceMinted = minterToMintedAmount[source_];\n uint256 destinationMinted = minterToMintedAmount[destination_];\n uint256 newDestinationMinted = destinationMinted + sourceMinted;\n\n if (newDestinationMinted > destinationCap) {\n revert MintLimitExceed();\n }\n\n minterToMintedAmount[source_] = 0;\n minterToMintedAmount[destination_] = newDestinationMinted;\n uint256 availableLimit;\n unchecked {\n availableLimit = destinationCap - newDestinationMinted;\n }\n\n emit MintLimitDecreased(destination_, availableLimit);\n emit MintLimitIncreased(source_, sourceCap);\n emit MintedTokensMigrated(source_, destination_);\n }\n\n /**\n * @notice Returns the blacklist status of the address.\n * @param user_ Address of user to check blacklist status.\n * @return bool status of blacklist.\n */\n function isBlackListed(address user_) external view returns (bool) {\n return _blacklist[user_];\n }\n\n /**\n * @dev Checks the minter cap and eligibility of receiver to receive tokens.\n * @param from_ Minter address.\n * @param to_ Receiver address.\n * @param amount_ Amount to be mint.\n * @custom:error MintLimitExceed is thrown when minting limit exceeds the cap.\n * @custom:event Emits MintLimitDecreased with minter address and available limits.\n */\n function _isEligibleToMint(address from_, address to_, uint256 amount_) internal {\n uint256 mintingCap = minterToCap[from_];\n uint256 totalMintedOld = minterToMintedAmount[from_];\n uint256 totalMintedNew = totalMintedOld + amount_;\n\n if (totalMintedNew > mintingCap) {\n revert MintLimitExceed();\n }\n minterToMintedAmount[from_] = totalMintedNew;\n uint256 availableLimit;\n unchecked {\n availableLimit = mintingCap - totalMintedNew;\n }\n emit MintLimitDecreased(from_, availableLimit);\n }\n\n /**\n * @dev This is post hook of burn function, increases minting limit of the minter.\n * @param from_ Minter address.\n * @param amount_ Amount burned.\n * @custom:error MintedAmountExceed is thrown when `amount_` is greater than the tokens minted by `from_`.\n * @custom:event Emits MintLimitIncreased with minter address and availabe limit.\n */\n function _increaseMintLimit(address from_, uint256 amount_) internal {\n uint256 totalMintedOld = minterToMintedAmount[from_];\n\n if (totalMintedOld < amount_) {\n revert MintedAmountExceed();\n }\n\n uint256 totalMintedNew;\n unchecked {\n totalMintedNew = totalMintedOld - amount_;\n }\n minterToMintedAmount[from_] = totalMintedNew;\n uint256 availableLimit = minterToCap[from_] - totalMintedNew;\n emit MintLimitIncreased(from_, availableLimit);\n }\n\n /**\n * @dev Checks the caller is allowed to call the specified fuction.\n * @param functionSig_ Function signatureon which access is to be checked.\n * @custom:error Unauthorized, thrown when unauthorised user try to access function.\n */\n function _ensureAllowed(string memory functionSig_) internal view {\n if (!IAccessControlManagerV8(accessControlManager).isAllowedToCall(msg.sender, functionSig_)) {\n revert Unauthorized();\n }\n }\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IAccessControlManagerV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\";\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { Ownable } from \"@openzeppelin/contracts/access/Ownable.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title TokenController\n * @author Venus\n * @notice TokenController contract acts as a governance and access control mechanism,\n * allowing the owner to manage minting restrictions and blacklist certain addresses to maintain control and security within the token ecosystem.\n * It provides a flexible framework for token-related operations.\n */\n\ncontract TokenController is Ownable, Pausable {\n /**\n * @notice Access control manager contract address.\n */\n address public accessControlManager;\n /**\n * @notice A Mapping used to keep track of the blacklist status of addresses.\n */\n mapping(address => bool) internal _blacklist;\n /**\n * @notice A mapping is used to keep track of the maximum amount a minter is permitted to mint.\n */\n mapping(address => uint256) public minterToCap;\n /**\n * @notice A Mapping used to keep track of the amount i.e already minted by minter.\n */\n mapping(address => uint256) public minterToMintedAmount;\n\n /**\n * @notice Emitted when the blacklist status of a user is updated.\n */\n event BlacklistUpdated(address indexed user, bool value);\n /**\n * @notice Emitted when the minting limit for a minter is increased.\n */\n event MintLimitIncreased(address indexed minter, uint256 newLimit);\n /**\n * @notice Emitted when the minting limit for a minter is decreased.\n */\n event MintLimitDecreased(address indexed minter, uint256 newLimit);\n /**\n * @notice Emitted when the minting cap for a minter is changed.\n */\n event MintCapChanged(address indexed minter, uint256 amount);\n /**\n * @notice Emitted when the address of the access control manager of the contract is updated.\n */\n event NewAccessControlManager(address indexed oldAccessControlManager, address indexed newAccessControlManager);\n /**\n * @notice Emitted when all minted tokens are migrated from one minter to another.\n */\n event MintedTokensMigrated(address indexed source, address indexed destination);\n\n /**\n * @notice This error is used to indicate that the minting limit has been exceeded. It is typically thrown when a minting operation would surpass the defined cap.\n */\n error MintLimitExceed();\n /**\n * @notice This error is used to indicate that `mint` `burn` and `transfer` actions are not allowed for the user address.\n */\n error AccountBlacklisted(address user);\n /**\n * @notice This error is used to indicate that sender is not allowed to perform this action.\n */\n error Unauthorized();\n /**\n * @notice This error is used to indicate that the new cap is greater than the previously minted tokens for the minter.\n */\n error NewCapNotGreaterThanMintedTokens();\n /**\n * @notice This error is used to indicate that the addresses must be different.\n */\n error AddressesMustDiffer();\n /**\n * @notice This error is used to indicate that the minter did not mint the required amount of tokens.\n */\n error MintedAmountExceed();\n\n /**\n * @param accessControlManager_ Address of access control manager contract.\n * @custom:error ZeroAddressNotAllowed is thrown when accessControlManager contract address is zero.\n */\n constructor(address accessControlManager_) {\n ensureNonzeroAddress(accessControlManager_);\n accessControlManager = accessControlManager_;\n }\n\n /**\n * @notice Pauses Token\n * @custom:access Controlled by AccessControlManager.\n */\n function pause() external {\n _ensureAllowed(\"pause()\");\n _pause();\n }\n\n /**\n * @notice Resumes Token\n * @custom:access Controlled by AccessControlManager.\n */\n function unpause() external {\n _ensureAllowed(\"unpause()\");\n _unpause();\n }\n\n /**\n * @notice Function to update blacklist.\n * @param user_ User address to be affected.\n * @param value_ Boolean to toggle value.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits BlacklistUpdated event.\n */\n function updateBlacklist(address user_, bool value_) external {\n _ensureAllowed(\"updateBlacklist(address,bool)\");\n _blacklist[user_] = value_;\n emit BlacklistUpdated(user_, value_);\n }\n\n /**\n * @notice Sets the minting cap for minter.\n * @param minter_ Minter address.\n * @param amount_ Cap for the minter.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintCapChanged.\n */\n function setMintCap(address minter_, uint256 amount_) external {\n _ensureAllowed(\"setMintCap(address,uint256)\");\n\n if (amount_ < minterToMintedAmount[minter_]) {\n revert NewCapNotGreaterThanMintedTokens();\n }\n\n minterToCap[minter_] = amount_;\n emit MintCapChanged(minter_, amount_);\n }\n\n /**\n * @notice Sets the address of the access control manager of this contract.\n * @dev Admin function to set the access control address.\n * @param newAccessControlAddress_ New address for the access control.\n * @custom:access Only owner.\n * @custom:event Emits NewAccessControlManager.\n * @custom:error ZeroAddressNotAllowed is thrown when newAccessControlAddress_ contract address is zero.\n */\n function setAccessControlManager(address newAccessControlAddress_) external onlyOwner {\n ensureNonzeroAddress(newAccessControlAddress_);\n emit NewAccessControlManager(accessControlManager, newAccessControlAddress_);\n accessControlManager = newAccessControlAddress_;\n }\n\n /**\n * @notice Migrates all minted tokens from one minter to another. This function is useful when we want to permanent take down a bridge.\n * @param source_ Minter address to migrate tokens from.\n * @param destination_ Minter address to migrate tokens to.\n * @custom:access Controlled by AccessControlManager.\n * @custom:error MintLimitExceed is thrown when the minting limit exceeds the cap after migration.\n * @custom:error AddressesMustDiffer is thrown when the source_ and destination_ addresses are the same.\n * @custom:event Emits MintLimitIncreased and MintLimitDecreased events for 'source' and 'destination'.\n * @custom:event Emits MintedTokensMigrated.\n */\n function migrateMinterTokens(address source_, address destination_) external {\n _ensureAllowed(\"migrateMinterTokens(address,address)\");\n\n if (source_ == destination_) {\n revert AddressesMustDiffer();\n }\n\n uint256 sourceCap = minterToCap[source_];\n uint256 destinationCap = minterToCap[destination_];\n\n uint256 sourceMinted = minterToMintedAmount[source_];\n uint256 destinationMinted = minterToMintedAmount[destination_];\n uint256 newDestinationMinted = destinationMinted + sourceMinted;\n\n if (newDestinationMinted > destinationCap) {\n revert MintLimitExceed();\n }\n\n minterToMintedAmount[source_] = 0;\n minterToMintedAmount[destination_] = newDestinationMinted;\n uint256 availableLimit;\n unchecked {\n availableLimit = destinationCap - newDestinationMinted;\n }\n\n emit MintLimitDecreased(destination_, availableLimit);\n emit MintLimitIncreased(source_, sourceCap);\n emit MintedTokensMigrated(source_, destination_);\n }\n\n /**\n * @notice Returns the blacklist status of the address.\n * @param user_ Address of user to check blacklist status.\n * @return bool status of blacklist.\n */\n function isBlackListed(address user_) external view returns (bool) {\n return _blacklist[user_];\n }\n\n /**\n * @dev Checks the minter cap and eligibility of receiver to receive tokens.\n * @param from_ Minter address.\n * @param to_ Receiver address.\n * @param amount_ Amount to be mint.\n * @custom:error MintLimitExceed is thrown when minting limit exceeds the cap.\n * @custom:event Emits MintLimitDecreased with minter address and available limits.\n */\n function _isEligibleToMint(address from_, address to_, uint256 amount_) internal {\n uint256 mintingCap = minterToCap[from_];\n uint256 totalMintedOld = minterToMintedAmount[from_];\n uint256 totalMintedNew = totalMintedOld + amount_;\n\n if (totalMintedNew > mintingCap) {\n revert MintLimitExceed();\n }\n minterToMintedAmount[from_] = totalMintedNew;\n uint256 availableLimit;\n unchecked {\n availableLimit = mintingCap - totalMintedNew;\n }\n emit MintLimitDecreased(from_, availableLimit);\n }\n\n /**\n * @dev This is post hook of burn function, increases minting limit of the minter.\n * @param from_ Minter address.\n * @param amount_ Amount burned.\n * @custom:error MintedAmountExceed is thrown when `amount_` is greater than the tokens minted by `from_`.\n * @custom:event Emits MintLimitIncreased with minter address and availabe limit.\n */\n function _increaseMintLimit(address from_, uint256 amount_) internal {\n uint256 totalMintedOld = minterToMintedAmount[from_];\n\n if (totalMintedOld < amount_) {\n revert MintedAmountExceed();\n }\n\n uint256 totalMintedNew;\n unchecked {\n totalMintedNew = totalMintedOld - amount_;\n }\n minterToMintedAmount[from_] = totalMintedNew;\n uint256 availableLimit = minterToCap[from_] - totalMintedNew;\n emit MintLimitIncreased(from_, availableLimit);\n }\n\n /**\n * @dev Checks the caller is allowed to call the specified fuction.\n * @param functionSig_ Function signatureon which access is to be checked.\n * @custom:error Unauthorized, thrown when unauthorised user try to access function.\n */\n function _ensureAllowed(string memory functionSig_) internal view {\n if (!IAccessControlManagerV8(accessControlManager).isAllowedToCall(msg.sender, functionSig_)) {\n revert Unauthorized();\n }\n }\n}\n" }, "contracts/Bridge/token/XVS.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\nimport { TokenController } from \"./TokenController.sol\";\n\n/**\n * @title XVS\n * @author Venus\n * @notice XVS contract serves as a customized ERC-20 token with additional minting and burning functionality.\n * It also incorporates access control features provided by the \"TokenController\" contract to ensure proper governance and restrictions on minting and burning operations.\n */\n\ncontract XVS is ERC20, TokenController {\n constructor(address accessControlManager_) ERC20(\"Venus XVS\", \"XVS\") TokenController(accessControlManager_) {}\n\n /**\n * @notice Creates `amount_` tokens and assigns them to `account_`, increasing\n * the total supply. Checks access and eligibility.\n * @param account_ Address to which tokens are assigned.\n * @param amount_ Amount of tokens to be assigned.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintLimitDecreased with new available limit.\n * @custom:error MintLimitExceed is thrown when minting amount exceeds the maximum cap.\n */\n function mint(address account_, uint256 amount_) external whenNotPaused {\n _ensureAllowed(\"mint(address,uint256)\");\n _isEligibleToMint(msg.sender, account_, amount_);\n _mint(account_, amount_);\n }\n\n /**\n * @notice Destroys `amount_` tokens from `account_`, reducing the\n * total supply. Checks access and eligibility.\n * @param account_ Address from which tokens be destroyed.\n * @param amount_ Amount of tokens to be destroyed.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintLimitIncreased with new available limit.\n */\n function burn(address account_, uint256 amount_) external whenNotPaused {\n _ensureAllowed(\"burn(address,uint256)\");\n _burn(account_, amount_);\n _increaseMintLimit(msg.sender, amount_);\n }\n\n /**\n * @notice Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n * @param from_ Address of account from which tokens are to be transferred.\n * @param to_ Address of the account to which tokens are to be transferred.\n * @param amount_ The amount of tokens to be transferred.\n * @custom:error AccountBlacklisted is thrown when either `from` or `to` address is blacklisted.\n */\n function _beforeTokenTransfer(address from_, address to_, uint256 amount_) internal override whenNotPaused {\n if (_blacklist[to_]) {\n revert AccountBlacklisted(to_);\n }\n if (_blacklist[from_]) {\n revert AccountBlacklisted(from_);\n }\n }\n}\n" - }, - "contracts/Bridge/XVSBridgeAdmin.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\n\npragma solidity 0.8.13;\n\nimport { AccessControlledV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { IXVSProxyOFT } from \"./interfaces/IXVSProxyOFT.sol\";\n\n/**\n * @title XVSBridgeAdmin\n * @author Venus\n * @notice The XVSBridgeAdmin contract extends a parent contract AccessControlledV8 for access control, and it manages an external contract called XVSProxyOFT.\n * It maintains a registry of function signatures and names,\n * allowing for dynamic function handling i.e checking of access control of interaction with only owner functions.\n */\ncontract XVSBridgeAdmin is AccessControlledV8 {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IXVSProxyOFT public immutable XVSBridge;\n /**\n * @notice A mapping keeps track of function signature associated with function name string.\n */\n mapping(bytes4 => string) public functionRegistry;\n\n /**\n * @notice emitted when function registry updated\n */\n event FunctionRegistryChanged(string signature, bool active);\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address XVSBridge_) {\n ensureNonzeroAddress(XVSBridge_);\n XVSBridge = IXVSProxyOFT(XVSBridge_);\n _disableInitializers();\n }\n\n /**\n * @param accessControlManager_ Address of access control manager contract.\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Invoked when called function does not exist in the contract.\n * @return Response of low level call.\n * @custom:access Controlled by AccessControlManager.\n */\n fallback(bytes calldata data) external returns (bytes memory) {\n string memory fun = _getFunctionName(msg.sig);\n require(bytes(fun).length != 0, \"Function not found\");\n _checkAccessAllowed(fun);\n (bool ok, bytes memory res) = address(XVSBridge).call(data);\n require(ok, \"call failed\");\n return res;\n }\n\n /**\n * @notice Sets trusted remote on particular chain.\n * @param remoteChainId_ Chain Id of the destination chain.\n * @param remoteAddress_ Address of the destination bridge.\n * @custom:access Controlled by AccessControlManager.\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\n */\n function setTrustedRemoteAddress(uint16 remoteChainId_, bytes calldata remoteAddress_) external {\n _checkAccessAllowed(\"setTrustedRemoteAddress(uint16,bytes)\");\n require(remoteChainId_ != 0, \"ChainId must not be zero\");\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\n XVSBridge.setTrustedRemoteAddress(remoteChainId_, remoteAddress_);\n }\n\n /**\n * @notice A setter for the registry of functions that are allowed to be executed from proposals.\n * @param signatures_ Function signature to be added or removed.\n * @param active_ bool value, should be true to add function.\n * @custom:access Only owner.\n * @custom:event Emits FunctionRegistryChanged if bool value of function changes.\n */\n function upsertSignature(string[] calldata signatures_, bool[] calldata active_) external onlyOwner {\n uint256 signatureLength = signatures_.length;\n require(signatureLength == active_.length, \"Input arrays must have the same length\");\n for (uint256 i; i < signatureLength; ) {\n bytes4 sigHash = bytes4(keccak256(bytes(signatures_[i])));\n bytes memory signature = bytes(functionRegistry[sigHash]);\n if (active_[i] && signature.length == 0) {\n functionRegistry[sigHash] = signatures_[i];\n emit FunctionRegistryChanged(signatures_[i], true);\n } else if (!active_[i] && signature.length != 0) {\n delete functionRegistry[sigHash];\n emit FunctionRegistryChanged(signatures_[i], false);\n }\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice This function transfers the ownership of the bridge from this contract to new owner.\n * @param newOwner_ New owner of the XVS Bridge.\n * @custom:access Controlled by AccessControlManager.\n */\n function transferBridgeOwnership(address newOwner_) external {\n _checkAccessAllowed(\"transferBridgeOwnership(address)\");\n XVSBridge.transferOwnership(newOwner_);\n }\n\n /**\n * @notice Returns true if remote address is trustedRemote corresponds to chainId_.\n * @param remoteChainId_ Chain Id of the destination chain.\n * @param remoteAddress_ Address of the destination bridge.\n * @custom:error ZeroAddressNotAllowed is thrown when remoteAddress_ contract address is zero.\n * @return Bool indicating whether the remote chain is trusted or not.\n */\n function isTrustedRemote(uint16 remoteChainId_, bytes calldata remoteAddress_) external returns (bool) {\n require(remoteChainId_ != 0, \"ChainId must not be zero\");\n ensureNonzeroAddress(bytesToAddress(remoteAddress_));\n return XVSBridge.isTrustedRemote(remoteChainId_, remoteAddress_);\n }\n\n /**\n * @notice Empty implementation of renounce ownership to avoid any mishappening.\n */\n function renounceOwnership() public override {}\n\n /**\n * @dev Returns function name string associated with function signature.\n * @param signature_ Four bytes of function signature.\n * @return Function signature corresponding to its hash.\n */\n function _getFunctionName(bytes4 signature_) internal view returns (string memory) {\n return functionRegistry[signature_];\n }\n\n /**\n * @notice Converts given bytes into address.\n * @param b Bytes to be converted into address.\n * @return Converted address of given bytes.\n */\n function bytesToAddress(bytes calldata b) private pure returns (address) {\n return address(uint160(bytes20(b)));\n }\n}\n" - }, - "contracts/Bridge/XVSProxyOFTDest.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { IXVS } from \"./interfaces/IXVS.sol\";\nimport { BaseXVSProxyOFT } from \"./BaseXVSProxyOFT.sol\";\n\n/**\n * @title XVSProxyOFTDest\n * @author Venus\n * @notice XVSProxyOFTDest contract builds upon the functionality of its parent contract, BaseXVSProxyOFT,\n * and focuses on managing token transfers to the destination chain.\n * It provides functions to check eligibility and perform the actual token transfers while maintaining strict access controls and pausing mechanisms.\n */\n\ncontract XVSProxyOFTDest is BaseXVSProxyOFT {\n /**\n * @notice Emits when stored message dropped without successful retrying.\n */\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\n\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\n\n /**\n * @notice Clear failed messages from the storage.\n * @param srcChainId_ Chain id of source\n * @param srcAddress_ Address of source followed by current bridge address\n * @param nonce_ Nonce_ of the transaction\n * @custom:access Only owner\n * @custom:event Emits DropFailedMessage on clearance of failed message.\n */\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\n }\n\n /**\n * @notice Returns the total circulating supply of the token on the destination chain i.e (total supply).\n * @return total circulating supply of the token on the destination chain.\n */\n function circulatingSupply() public view override returns (uint256) {\n return innerToken.totalSupply();\n }\n\n /**\n * @notice Debit tokens from the given address\n * @param from_ Address from which tokens to be debited\n * @param dstChainId_ Destination chain id\n * @param amount_ Amount of tokens to be debited\n * @return Actual amount debited\n */\n function _debitFrom(\n address from_,\n uint16 dstChainId_,\n bytes32,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n require(from_ == _msgSender(), \"ProxyOFT: owner is not send caller\");\n _isEligibleToSend(from_, dstChainId_, amount_);\n IXVS(address(innerToken)).burn(from_, amount_);\n return amount_;\n }\n\n /**\n * @notice Credit tokens in the given account\n * @param srcChainId_ Source chain id\n * @param toAddress_ Address on which token will be credited\n * @param amount_ Amount of tokens to be credited\n * @return Actual amount credited\n */\n function _creditTo(\n uint16 srcChainId_,\n address toAddress_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\n IXVS(address(innerToken)).mint(toAddress_, amount_);\n return amount_;\n }\n}\n" - }, - "contracts/Bridge/XVSProxyOFTSrc.sol": { - "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.13;\n\nimport { SafeERC20, IERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BaseXVSProxyOFT } from \"./BaseXVSProxyOFT.sol\";\n\n/**\n * @title XVSProxyOFTSrc\n * @author Venus\n * @notice XVSProxyOFTSrc contract serves as a crucial component for cross-chain token transactions,\n * focusing on the source side of these transactions.\n * It monitors the total amount transferred to other chains, ensuring it complies with defined limits,\n * and provides functions for transferring tokens while maintaining control over the circulating supply on the source chain.\n */\n\ncontract XVSProxyOFTSrc is BaseXVSProxyOFT {\n using SafeERC20 for IERC20;\n /**\n * @notice Total amount that is transferred from this chain to other chains.\n */\n uint256 public outboundAmount;\n\n /**\n * @notice Emits when locked token released manually by owner.\n */\n event FallbackWithdraw(address indexed to, uint256 amount);\n /**\n * @notice Emits when stored message dropped without successful retrying.\n */\n event DropFailedMessage(uint16 srcChainId, bytes indexed srcAddress, uint64 nonce);\n /**\n * @notice Event emitted when tokens are forcefully locked.\n */\n event FallbackDeposit(address indexed from, uint256 amount_);\n\n constructor(\n address tokenAddress_,\n uint8 sharedDecimals_,\n address lzEndpoint_,\n address oracle_\n ) BaseXVSProxyOFT(tokenAddress_, sharedDecimals_, lzEndpoint_, oracle_) {}\n\n /**\n * @notice Only call it when there is no way to recover the failed message.\n * `dropFailedMessage` must be called first if transaction is from remote->local chain to avoid double spending.\n * @param to_ The address to withdraw to\n * @param amount_ The amount of withdrawal\n * @custom:access Only owner.\n * @custom:event Emits FallbackWithdraw, once done with transfer.\n */\n function fallbackWithdraw(address to_, uint256 amount_) external onlyOwner {\n require(outboundAmount >= amount_, \"Withdraw amount should be less than outbound amount\");\n unchecked {\n outboundAmount -= amount_;\n }\n _transferFrom(address(this), to_, amount_);\n emit FallbackWithdraw(to_, amount_);\n }\n\n /**\n * @notice Forces the lock of tokens by increasing outbound amount and transferring tokens from the sender to the contract.\n * @param amount_ The amount of tokens to lock.\n * @param depositor_ Address of the depositor.\n * @custom:access Only owner.\n * @custom:event Emits FallbackDeposit, once done with transfer.\n */\n function fallbackDeposit(address depositor_, uint256 amount_) external onlyOwner {\n (uint256 actualAmount, ) = _removeDust(amount_);\n\n outboundAmount += actualAmount;\n uint256 cap = _sd2ld(type(uint64).max);\n require(cap >= outboundAmount, \"ProxyOFT: outboundAmount overflow\");\n\n _transferFrom(depositor_, address(this), actualAmount);\n\n emit FallbackDeposit(depositor_, actualAmount);\n }\n\n /**\n * @notice Clear failed messages from the storage.\n * @param srcChainId_ Chain id of source\n * @param srcAddress_ Address of source followed by current bridge address\n * @param nonce_ Nonce_ of the transaction\n * @custom:access Only owner.\n * @custom:event Emits DropFailedMessage on clearance of failed message.\n */\n function dropFailedMessage(uint16 srcChainId_, bytes memory srcAddress_, uint64 nonce_) external onlyOwner {\n failedMessages[srcChainId_][srcAddress_][nonce_] = bytes32(0);\n emit DropFailedMessage(srcChainId_, srcAddress_, nonce_);\n }\n\n /**\n * @notice Returns the total circulating supply of the token on the source chain i.e (total supply - locked in this contract).\n * @return Returns difference in total supply and the outbound amount.\n */\n function circulatingSupply() public view override returns (uint256) {\n return innerToken.totalSupply() - outboundAmount;\n }\n\n /**\n * @notice Debit tokens from the given address\n * @param from_ Address from which tokens to be debited\n * @param dstChainId_ Destination chain id\n * @param amount_ Amount of tokens to be debited\n * @return Actual amount debited\n */\n function _debitFrom(\n address from_,\n uint16 dstChainId_,\n bytes32,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n require(from_ == _msgSender(), \"ProxyOFT: owner is not send caller\");\n _isEligibleToSend(from_, dstChainId_, amount_);\n\n uint256 amount = _transferFrom(from_, address(this), amount_);\n\n outboundAmount += amount;\n uint256 cap = _sd2ld(type(uint64).max);\n require(cap >= outboundAmount, \"ProxyOFT: outboundAmount overflow\");\n\n return amount;\n }\n\n /**\n * @notice Credit tokens in the given account\n * @param srcChainId_ Source chain id\n * @param toAddress_ Address on which token will be credited\n * @param amount_ Amount of tokens to be credited\n * @return Actual amount credited\n */\n function _creditTo(\n uint16 srcChainId_,\n address toAddress_,\n uint256 amount_\n ) internal override whenNotPaused returns (uint256) {\n _isEligibleToReceive(toAddress_, srcChainId_, amount_);\n outboundAmount -= amount_;\n // tokens are already in this contract, so no need to transfer\n if (toAddress_ == address(this)) {\n return amount_;\n }\n\n return _transferFrom(address(this), toAddress_, amount_);\n }\n}\n" + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\nimport { TokenController } from \"./TokenController.sol\";\n\n/**\n * @title XVS\n * @author Venus\n * @notice XVS contract serves as a customized ERC-20 token with additional minting and burning functionality.\n * It also incorporates access control features provided by the \"TokenController\" contract to ensure proper governance and restrictions on minting and burning operations.\n */\n\ncontract XVS is ERC20, TokenController {\n constructor(address accessControlManager_) ERC20(\"Venus XVS\", \"XVS\") TokenController(accessControlManager_) {}\n\n /**\n * @notice Creates `amount_` tokens and assigns them to `account_`, increasing\n * the total supply. Checks access and eligibility.\n * @param account_ Address to which tokens are assigned.\n * @param amount_ Amount of tokens to be assigned.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintLimitDecreased with new available limit.\n * @custom:error MintLimitExceed is thrown when minting amount exceeds the maximum cap.\n */\n function mint(address account_, uint256 amount_) external whenNotPaused {\n _ensureAllowed(\"mint(address,uint256)\");\n _isEligibleToMint(msg.sender, account_, amount_);\n _mint(account_, amount_);\n }\n\n /**\n * @notice Destroys `amount_` tokens from `account_`, reducing the\n * total supply. Checks access and eligibility.\n * @param account_ Address from which tokens be destroyed.\n * @param amount_ Amount of tokens to be destroyed.\n * @custom:access Controlled by AccessControlManager.\n * @custom:event Emits MintLimitIncreased with new available limit.\n */\n function burn(address account_, uint256 amount_) external whenNotPaused {\n _ensureAllowed(\"burn(address,uint256)\");\n _burn(account_, amount_);\n _increaseMintLimit(msg.sender, amount_);\n }\n\n /**\n * @notice Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n * @param from_ Address of account from which tokens are to be transferred.\n * @param to_ Address of the account to which tokens are to be transferred.\n * @param amount_ The amount of tokens to be transferred.\n * @custom:error AccountBlacklisted is thrown when either `from` or `to` address is blacklisted.\n */\n function _beforeTokenTransfer(address from_, address to_, uint256 amount_) internal override whenNotPaused {\n if (_blacklist[to_]) {\n revert AccountBlacklisted(to_);\n }\n if (_blacklist[from_]) {\n revert AccountBlacklisted(from_);\n }\n }\n}\n" }, "contracts/test/MockToken.sol": { "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { LZEndpointMock } from \"@layerzerolabs/solidity-examples/contracts/lzApp/mocks/LZEndpointMock.sol\";\nimport { AccessControlManager } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol\";\n\ncontract MockToken is ERC20 {\n uint8 private immutable _decimals;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function decimals() public view virtual override returns (uint8) {\n return _decimals;\n }\n}\n" @@ -163,6 +136,7 @@ "yul": true } }, + "evmVersion": "paris", "outputSelection": { "*": { "*": [ diff --git a/hardhat.config.ts b/hardhat.config.ts index fcb8189..31409ed 100644 --- a/hardhat.config.ts +++ b/hardhat.config.ts @@ -49,6 +49,10 @@ extendConfig((config: HardhatConfig) => { "node_modules/@venusprotocol/governance-contracts/deployments/ethereum", "node_modules/@venusprotocol/oracle/deployments/ethereum", ], + arbitrumsepolia: [ + "node_modules/@venusprotocol/governance-contracts/deployments/arbitrumsepolia", + "node_modules/@venusprotocol/oracle/deployments/arbitrumsepolia", + ], }, }; } From 565029087632e93024bc61f1cb029bdb078a7bd2 Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Mon, 22 Apr 2024 05:49:52 +0000 Subject: [PATCH 12/17] feat: updating deployment files --- deployments/arbitrumsepolia.json | 10 +++++----- deployments/arbitrumsepolia_addresses.json | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/deployments/arbitrumsepolia.json b/deployments/arbitrumsepolia.json index f5bb774..17746d4 100644 --- a/deployments/arbitrumsepolia.json +++ b/deployments/arbitrumsepolia.json @@ -168,7 +168,7 @@ ] }, "XVS": { - "address": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", + "address": "0x877Dc896e7b13096D3827872e396927BbE704407", "abi": [ { "inputs": [ @@ -887,7 +887,7 @@ ] }, "XVSBridgeAdmin": { - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "abi": [ { "anonymous": false, @@ -1348,7 +1348,7 @@ ] }, "XVSBridgeAdmin_Implementation": { - "address": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", + "address": "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", "abi": [ { "inputs": [ @@ -1680,7 +1680,7 @@ ] }, "XVSBridgeAdmin_Proxy": { - "address": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", + "address": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", "abi": [ { "inputs": [ @@ -1829,7 +1829,7 @@ ] }, "XVSProxyOFTDest": { - "address": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917", + "address": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4", "abi": [ { "inputs": [ diff --git a/deployments/arbitrumsepolia_addresses.json b/deployments/arbitrumsepolia_addresses.json index f895629..4212857 100644 --- a/deployments/arbitrumsepolia_addresses.json +++ b/deployments/arbitrumsepolia_addresses.json @@ -3,10 +3,10 @@ "chainId": "421614", "addresses": { "DefaultProxyAdmin": "0xA78A1Df376c3CEeBC5Fab574fe6EdDbbF76fd03e", - "XVS": "0x47fA6E9F717c9eB081c4734FfB5a1EcD70508891", - "XVSBridgeAdmin": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", - "XVSBridgeAdmin_Implementation": "0xd2048bD9e1D9A515cc57E270D0928B1127348ae1", - "XVSBridgeAdmin_Proxy": "0x0DC3d6717727FD5a023e41bA8134640ca18f3E48", - "XVSProxyOFTDest": "0xE9B66800E63888DE29c4c9131faadbDbDCfae917" + "XVS": "0x877Dc896e7b13096D3827872e396927BbE704407", + "XVSBridgeAdmin": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", + "XVSBridgeAdmin_Implementation": "0x3514FB2bbAf4D749af5908311B4c1867Beb349cb", + "XVSBridgeAdmin_Proxy": "0xc94578caCC89a29B044a0a1D54d20d48A645E5C8", + "XVSProxyOFTDest": "0xFdC5cEC63FD167DA46cF006585b30D03B104eFD4" } } From eb6e31b7759ebcbb5bcac9c5b496fad3cf45a6f7 Mon Sep 17 00:00:00 2001 From: Venus Tools Date: Mon, 22 Apr 2024 10:00:54 +0000 Subject: [PATCH 13/17] chore(release): 2.0.0-dev.2 [skip ci] ## [2.0.0-dev.2](https://github.com/VenusProtocol/token-bridge/compare/v2.0.0-dev.1...v2.0.0-dev.2) (2024-04-22) --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 8c2d491..31d14d0 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@venusprotocol/token-bridge", - "version": "2.0.0-dev.1", + "version": "2.0.0-dev.2", "description": "Contracts to bridge tokens using LayerZero technology and applying some rules on top of it", "files": [ "artifacts", From 345f9bb8b6188fee6fcf36464574eb7bd91c1913 Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Wed, 24 Apr 2024 15:55:29 +0530 Subject: [PATCH 14/17] refactor: update maxDailyReceiveLimit and maxSingleReceiveTransactionLimit values --- helpers/deploymentConfig.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index 02bc379..153236a 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -185,8 +185,8 @@ function createMethodEntries( minDstGas: number = 300000, maxDailyLimit: BigNumber = parseUnits("50000", 18), maxSingleTransactionLimit: BigNumber = parseUnits("10000", 18), - maxDailyReceiveLimit: BigNumber = parseUnits("50000", 18), - maxSingleReceiveTransactionLimit: BigNumber = parseUnits("10000", 18), + maxDailyReceiveLimit: BigNumber = parseUnits("51000", 18), + maxSingleReceiveTransactionLimit: BigNumber = parseUnits("10200", 18), ): MethodEntry[] { return [ { method: "setMinDstGas(uint16,uint16,uint256)", args: [chainId, 0, minDstGas] }, From d28836dd2d0be9aaee55ec9e537114ea5a01cd04 Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Thu, 25 Apr 2024 11:43:45 +0530 Subject: [PATCH 15/17] chore: update oracle package version --- package.json | 2 +- yarn.lock | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/package.json b/package.json index 8c2d491..94b311d 100644 --- a/package.json +++ b/package.json @@ -61,7 +61,7 @@ "@typescript-eslint/eslint-plugin": "^5.27.1", "@typescript-eslint/parser": "^5.27.1", "@venusprotocol/governance-contracts": "^2.0.0", - "@venusprotocol/oracle": "^2.0.0", + "@venusprotocol/oracle": "^2.2.0-dev.3", "@venusprotocol/solidity-utilities": "2.0.0", "bignumber.js": "9.0.0", "chai": "^4.3.6", diff --git a/yarn.lock b/yarn.lock index 0e7f433..cb1512b 100644 --- a/yarn.lock +++ b/yarn.lock @@ -3074,9 +3074,9 @@ __metadata: languageName: node linkType: hard -"@venusprotocol/oracle@npm:^2.0.0": - version: 2.0.0 - resolution: "@venusprotocol/oracle@npm:2.0.0" +"@venusprotocol/oracle@npm:^2.2.0-dev.3": + version: 2.2.0-dev.3 + resolution: "@venusprotocol/oracle@npm:2.2.0-dev.3" dependencies: "@chainlink/contracts": ^0.5.1 "@defi-wonderland/smock": ^2.3.4 @@ -3091,7 +3091,7 @@ __metadata: hardhat-deploy: ^0.11.14 module-alias: ^2.2.2 solidity-docgen: ^0.6.0-beta.29 - checksum: 00673550cdc63244eba2872b32253454a3b2062c2759075c68449b2923f2bb645e971d5ca0cbfd288bddd092d346a5f3e49d10bbb97d743fb33f9ece14179723 + checksum: f35d0b83f7b4af21fbfb76e595c612cbdbcd96041bc55f17371b6638b73a3376e658e42022af6c050b1f8ce37dc1a3bca40657ffd392734523bfa91de3f06210 languageName: node linkType: hard @@ -3161,7 +3161,7 @@ __metadata: "@typescript-eslint/eslint-plugin": ^5.27.1 "@typescript-eslint/parser": ^5.27.1 "@venusprotocol/governance-contracts": ^2.0.0 - "@venusprotocol/oracle": ^2.0.0 + "@venusprotocol/oracle": ^2.2.0-dev.3 "@venusprotocol/solidity-utilities": 2.0.0 bignumber.js: 9.0.0 chai: ^4.3.6 From 9978ea562aef78df585c2cc3dd49792ace4afc8d Mon Sep 17 00:00:00 2001 From: Debugger022 Date: Thu, 25 Apr 2024 16:30:35 +0530 Subject: [PATCH 16/17] chore: update oracle package version --- package.json | 2 +- yarn.lock | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/package.json b/package.json index 94b311d..dc438ba 100644 --- a/package.json +++ b/package.json @@ -61,7 +61,7 @@ "@typescript-eslint/eslint-plugin": "^5.27.1", "@typescript-eslint/parser": "^5.27.1", "@venusprotocol/governance-contracts": "^2.0.0", - "@venusprotocol/oracle": "^2.2.0-dev.3", + "@venusprotocol/oracle": "^2.2.0", "@venusprotocol/solidity-utilities": "2.0.0", "bignumber.js": "9.0.0", "chai": "^4.3.6", diff --git a/yarn.lock b/yarn.lock index cb1512b..aac8c0f 100644 --- a/yarn.lock +++ b/yarn.lock @@ -3074,9 +3074,9 @@ __metadata: languageName: node linkType: hard -"@venusprotocol/oracle@npm:^2.2.0-dev.3": - version: 2.2.0-dev.3 - resolution: "@venusprotocol/oracle@npm:2.2.0-dev.3" +"@venusprotocol/oracle@npm:^2.2.0": + version: 2.2.0 + resolution: "@venusprotocol/oracle@npm:2.2.0" dependencies: "@chainlink/contracts": ^0.5.1 "@defi-wonderland/smock": ^2.3.4 @@ -3091,7 +3091,7 @@ __metadata: hardhat-deploy: ^0.11.14 module-alias: ^2.2.2 solidity-docgen: ^0.6.0-beta.29 - checksum: f35d0b83f7b4af21fbfb76e595c612cbdbcd96041bc55f17371b6638b73a3376e658e42022af6c050b1f8ce37dc1a3bca40657ffd392734523bfa91de3f06210 + checksum: 5ff2e0af88dbbe077c423b62f9c92cd0a9173f4a618f79bc9aec9df8b96e6e908e565adc82175dbe78b200c3d77abeb48878506fd85ada2c8c87b8d568dc1a3e languageName: node linkType: hard @@ -3161,7 +3161,7 @@ __metadata: "@typescript-eslint/eslint-plugin": ^5.27.1 "@typescript-eslint/parser": ^5.27.1 "@venusprotocol/governance-contracts": ^2.0.0 - "@venusprotocol/oracle": ^2.2.0-dev.3 + "@venusprotocol/oracle": ^2.2.0 "@venusprotocol/solidity-utilities": 2.0.0 bignumber.js: 9.0.0 chai: ^4.3.6 From be4dfc751b7eea51a784b554ac9810b3bc3e045e Mon Sep 17 00:00:00 2001 From: Venus Tools Date: Thu, 25 Apr 2024 12:27:28 +0000 Subject: [PATCH 17/17] chore(release): 2.0.0-dev.3 [skip ci] ## [2.0.0-dev.3](https://github.com/VenusProtocol/token-bridge/compare/v2.0.0-dev.2...v2.0.0-dev.3) (2024-04-25) ### Features * add deployments for XVS and XVSBridge ([63368ac](https://github.com/VenusProtocol/token-bridge/commit/63368aca74fe91e44c4b2f25e74d713b81db3bcd)) * updating deployment files ([5650290](https://github.com/VenusProtocol/token-bridge/commit/565029087632e93024bc61f1cb029bdb078a7bd2)) * updating deployment files ([a763f74](https://github.com/VenusProtocol/token-bridge/commit/a763f74f996d4fbc1f805660c8c9c7415409a03a)) * updating deployment files ([def4075](https://github.com/VenusProtocol/token-bridge/commit/def4075c216fbab925a4ea0d73ecffa7c83492d1)) ### Bug Fixes * chain id for arbitrumsepolia methods ([eddc2b2](https://github.com/VenusProtocol/token-bridge/commit/eddc2b2632383686b6324d494e41bf61b1cc75a7)) --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index c6e258b..f2cda8c 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@venusprotocol/token-bridge", - "version": "2.0.0-dev.2", + "version": "2.0.0-dev.3", "description": "Contracts to bridge tokens using LayerZero technology and applying some rules on top of it", "files": [ "artifacts",