Warning! Contract bytecode has been changed and doesn't match the verified one. Therefore, interaction with this smart contract may be risky.
- Contract name:
- ERC20Vault
- Optimization enabled
- true
- Compiler version
- v0.8.24+commit.e11b9ed9
- Optimization runs
- 200
- EVM Version
- cancun
- Verified at
- 2024-05-27T09:03:40.159765Z
contracts/tokenvault/ERC20Vault.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import "../bridge/IQuotaManager.sol";
import "../common/LibStrings.sol";
import "../libs/LibAddress.sol";
import "./IBridgedERC20.sol";
import "./BaseVault.sol";
/// @title ERC20Vault
/// @notice This vault holds all ERC20 tokens (excluding Ether) that users have
/// deposited. It also manages the mapping between canonical ERC20 tokens and
/// their bridged tokens. This vault does not support rebase/elastic tokens.
/// @dev Labeled in AddressResolver as "erc20_vault".
/// @custom:security-contact security@taiko.xyz
contract ERC20Vault is BaseVault {
using LibAddress for address;
using SafeERC20 for IERC20;
uint256 public constant MIN_MIGRATION_DELAY = 90 days;
/// @dev Represents a canonical ERC20 token.
struct CanonicalERC20 {
uint64 chainId;
address addr;
uint8 decimals;
string symbol;
string name;
}
/// @dev Represents an operation to send tokens to another chain.
/// 4 slots
struct BridgeTransferOp {
uint64 destChainId;
address destOwner;
address to;
uint64 fee;
address token;
uint32 gasLimit;
uint256 amount;
}
/// @notice Mappings from bridged tokens to their canonical tokens.
mapping(address btoken => CanonicalERC20 canonical) public bridgedToCanonical;
/// @notice Mappings from canonical tokens to their bridged tokens. Also storing
/// the chainId for tokens across other chains aside from Ethereum.
mapping(uint256 chainId => mapping(address ctoken => address btoken)) public canonicalToBridged;
/// @notice Mappings from bridged tokens to their blacklist status.
mapping(address btoken => bool blacklisted) public btokenBlacklist;
/// @notice Mappings from ctoken to its last migration timestamp.
mapping(uint256 chainId => mapping(address ctoken => uint256 timestamp)) public
lastMigrationStart;
uint256[46] private __gap;
/// @notice Emitted when a new bridged token is deployed.
/// @param srcChainId The chain ID of the canonical token.
/// @param ctoken The address of the canonical token.
/// @param btoken The address of the bridged token.
/// @param ctokenSymbol The symbol of the canonical token.
/// @param ctokenName The name of the canonical token.
/// @param ctokenDecimal The decimal of the canonical token.
event BridgedTokenDeployed(
uint256 indexed srcChainId,
address indexed ctoken,
address indexed btoken,
string ctokenSymbol,
string ctokenName,
uint8 ctokenDecimal
);
/// @notice Emitted when a bridged token is changed.
/// @param srcChainId The chain ID of the canonical token.
/// @param ctoken The address of the canonical token.
/// @param btokenOld The address of the old bridged token.
/// @param btokenNew The address of the new bridged token.
/// @param ctokenSymbol The symbol of the canonical token.
/// @param ctokenName The name of the canonical token.
/// @param ctokenDecimal The decimal of the canonical token.
event BridgedTokenChanged(
uint256 indexed srcChainId,
address indexed ctoken,
address btokenOld,
address btokenNew,
string ctokenSymbol,
string ctokenName,
uint8 ctokenDecimal
);
/// @notice Emitted when a token is sent to another chain.
/// @param msgHash The hash of the message.
/// @param from The address of the sender.
/// @param to The address of the recipient.
/// @param destChainId The chain ID of the destination chain.
/// @param ctoken The address of the canonical token.
/// @param token The address of the bridged token.
/// @param amount The amount of tokens sent.
event TokenSent(
bytes32 indexed msgHash,
address indexed from,
address indexed to,
uint64 destChainId,
address ctoken,
address token,
uint256 amount
);
/// @notice Emitted when a token is released from a message.
/// @param msgHash The hash of the message.
/// @param from The address of the sender.
/// @param ctoken The address of the canonical token.
/// @param token The address of the bridged token.
/// @param amount The amount of tokens released.
event TokenReleased(
bytes32 indexed msgHash, address indexed from, address ctoken, address token, uint256 amount
);
/// @notice Emitted when a token is received from another chain.
/// @param msgHash The hash of the message.
/// @param from The address of the sender.
/// @param to The address of the recipient.
/// @param srcChainId The chain ID of the source chain.
/// @param ctoken The address of the canonical token.
/// @param token The address of the bridged token.
/// @param amount The amount of tokens received.
event TokenReceived(
bytes32 indexed msgHash,
address indexed from,
address indexed to,
uint64 srcChainId,
address ctoken,
address token,
uint256 amount
);
error VAULT_BTOKEN_BLACKLISTED();
error VAULT_CTOKEN_MISMATCH();
error VAULT_INVALID_TOKEN();
error VAULT_INVALID_AMOUNT();
error VAULT_INVALID_NEW_BTOKEN();
error VAULT_LAST_MIGRATION_TOO_CLOSE();
/// @notice Initializes the contract.
/// @param _owner The owner of this contract. msg.sender will be used if this value is zero.
/// @param _addressManager The address of the {AddressManager} contract.
function init(address _owner, address _addressManager) external initializer {
__Essential_init(_owner, _addressManager);
}
/// @notice Change bridged token.
/// @param _ctoken The canonical token.
/// @param _btokenNew The new bridged token address.
/// @return btokenOld_ The old bridged token address.
function changeBridgedToken(
CanonicalERC20 calldata _ctoken,
address _btokenNew
)
external
onlyOwner
nonReentrant
returns (address btokenOld_)
{
if (_btokenNew == address(0) || bridgedToCanonical[_btokenNew].addr != address(0)) {
revert VAULT_INVALID_NEW_BTOKEN();
}
if (btokenBlacklist[_btokenNew]) revert VAULT_BTOKEN_BLACKLISTED();
uint256 _lastMigrationStart = lastMigrationStart[_ctoken.chainId][_ctoken.addr];
if (block.timestamp < _lastMigrationStart + MIN_MIGRATION_DELAY) {
revert VAULT_LAST_MIGRATION_TOO_CLOSE();
}
btokenOld_ = canonicalToBridged[_ctoken.chainId][_ctoken.addr];
if (btokenOld_ != address(0)) {
CanonicalERC20 memory ctoken = bridgedToCanonical[btokenOld_];
// The ctoken must match the saved one.
if (keccak256(abi.encode(_ctoken)) != keccak256(abi.encode(ctoken))) {
revert VAULT_CTOKEN_MISMATCH();
}
delete bridgedToCanonical[btokenOld_];
btokenBlacklist[btokenOld_] = true;
// Start the migration
if (
btokenOld_.supportsInterface(type(IBridgedERC20Migratable).interfaceId)
&& _btokenNew.supportsInterface(type(IBridgedERC20Migratable).interfaceId)
) {
IBridgedERC20Migratable(btokenOld_).changeMigrationStatus(_btokenNew, false);
IBridgedERC20Migratable(_btokenNew).changeMigrationStatus(btokenOld_, true);
}
}
bridgedToCanonical[_btokenNew] = _ctoken;
canonicalToBridged[_ctoken.chainId][_ctoken.addr] = _btokenNew;
lastMigrationStart[_ctoken.chainId][_ctoken.addr] = block.timestamp;
emit BridgedTokenChanged({
srcChainId: _ctoken.chainId,
ctoken: _ctoken.addr,
btokenOld: btokenOld_,
btokenNew: _btokenNew,
ctokenSymbol: _ctoken.symbol,
ctokenName: _ctoken.name,
ctokenDecimal: _ctoken.decimals
});
}
/// @notice Transfers ERC20 tokens to this vault and sends a message to the
/// destination chain so the user can receive the same amount of tokens by
/// invoking the message call.
/// @param _op Option for sending ERC20 tokens.
/// @return message_ The constructed message.
function sendToken(BridgeTransferOp calldata _op)
external
payable
whenNotPaused
nonReentrant
returns (IBridge.Message memory message_)
{
if (_op.amount == 0) revert VAULT_INVALID_AMOUNT();
if (_op.token == address(0)) revert VAULT_INVALID_TOKEN();
if (btokenBlacklist[_op.token]) revert VAULT_BTOKEN_BLACKLISTED();
(bytes memory data, CanonicalERC20 memory ctoken, uint256 balanceChange) =
_handleMessage(_op);
IBridge.Message memory message = IBridge.Message({
id: 0, // will receive a new value
from: address(0), // will receive a new value
srcChainId: 0, // will receive a new value
destChainId: _op.destChainId,
srcOwner: msg.sender,
destOwner: _op.destOwner != address(0) ? _op.destOwner : msg.sender,
to: resolve(_op.destChainId, name(), false),
value: msg.value - _op.fee,
fee: _op.fee,
gasLimit: _op.gasLimit,
data: data
});
bytes32 msgHash;
(msgHash, message_) =
IBridge(resolve(LibStrings.B_BRIDGE, false)).sendMessage{ value: msg.value }(message);
emit TokenSent({
msgHash: msgHash,
from: message_.srcOwner,
to: _op.to,
destChainId: _op.destChainId,
ctoken: ctoken.addr,
token: _op.token,
amount: balanceChange
});
}
/// @inheritdoc IMessageInvocable
function onMessageInvocation(bytes calldata _data) public payable whenNotPaused nonReentrant {
(CanonicalERC20 memory ctoken, address from, address to, uint256 amount) =
abi.decode(_data, (CanonicalERC20, address, address, uint256));
// `onlyFromBridge` checked in checkProcessMessageContext
IBridge.Context memory ctx = checkProcessMessageContext();
// Don't allow sending to disallowed addresses.
// Don't send the tokens back to `from` because `from` is on the source chain.
checkToAddress(to);
// Transfer the ETH and the tokens to the `to` address
address token = _transferTokens(ctoken, to, amount);
to.sendEtherAndVerify(msg.value);
emit TokenReceived({
msgHash: ctx.msgHash,
from: from,
to: to,
srcChainId: ctx.srcChainId,
ctoken: ctoken.addr,
token: token,
amount: amount
});
}
/// @inheritdoc IRecallableSender
function onMessageRecalled(
IBridge.Message calldata _message,
bytes32 _msgHash
)
external
payable
override
whenNotPaused
nonReentrant
{
// `onlyFromBridge` checked in checkRecallMessageContext
checkRecallMessageContext();
(bytes memory data) = abi.decode(_message.data[4:], (bytes));
(CanonicalERC20 memory ctoken,,, uint256 amount) =
abi.decode(data, (CanonicalERC20, address, address, uint256));
// Transfer the ETH and tokens back to the owner
address token = _transferTokens(ctoken, _message.srcOwner, amount);
_message.srcOwner.sendEtherAndVerify(_message.value);
emit TokenReleased({
msgHash: _msgHash,
from: _message.srcOwner,
ctoken: ctoken.addr,
token: token,
amount: amount
});
}
/// @inheritdoc BaseVault
function name() public pure override returns (bytes32) {
return LibStrings.B_ERC20_VAULT;
}
function _transferTokens(
CanonicalERC20 memory _ctoken,
address _to,
uint256 _amount
)
private
returns (address token_)
{
if (_ctoken.chainId == block.chainid) {
token_ = _ctoken.addr;
IERC20(token_).safeTransfer(_to, _amount);
} else {
token_ = _getOrDeployBridgedToken(_ctoken);
//For native bridged tokens (like USDC), the mint() signature is the same, so no need to
// check.
IBridgedERC20(token_).mint(_to, _amount);
}
_consumeTokenQuota(token_, _amount);
}
/// @dev Handles the message on the source chain and returns the encoded
/// call on the destination call.
/// @param _op The BridgeTransferOp object.
/// @return msgData_ Encoded message data.
/// @return ctoken_ The canonical token.
/// @return balanceChange_ User token balance actual change after the token
/// transfer. This value is calculated so we do not assume token balance
/// change is the amount of token transferred away.
function _handleMessage(BridgeTransferOp calldata _op)
private
returns (bytes memory msgData_, CanonicalERC20 memory ctoken_, uint256 balanceChange_)
{
// If it's a bridged token
CanonicalERC20 storage _ctoken = bridgedToCanonical[_op.token];
if (_ctoken.addr != address(0)) {
ctoken_ = _ctoken;
// Following the "transfer and burn" pattern, as used by USDC
IERC20(_op.token).safeTransferFrom(msg.sender, address(this), _op.amount);
IBridgedERC20(_op.token).burn(_op.amount);
balanceChange_ = _op.amount;
} else {
// If it's a canonical token
ctoken_ = CanonicalERC20({
chainId: uint64(block.chainid),
addr: _op.token,
decimals: _safeDecimals(_op.token),
symbol: safeSymbol(_op.token),
name: safeName(_op.token)
});
// Query the balance then query it again to get the actual amount of
// token transferred into this address, this is more accurate than
// simply using `amount` -- some contract may deduct a fee from the
// transferred amount.
IERC20 t = IERC20(_op.token);
uint256 _balance = t.balanceOf(address(this));
t.safeTransferFrom(msg.sender, address(this), _op.amount);
balanceChange_ = t.balanceOf(address(this)) - _balance;
}
msgData_ = abi.encodeCall(
this.onMessageInvocation, abi.encode(ctoken_, msg.sender, _op.to, balanceChange_)
);
}
/// @dev Retrieve or deploy a bridged ERC20 token contract.
/// @param ctoken CanonicalERC20 data.
/// @return btoken Address of the bridged token contract.
function _getOrDeployBridgedToken(CanonicalERC20 memory ctoken)
private
returns (address btoken)
{
btoken = canonicalToBridged[ctoken.chainId][ctoken.addr];
if (btoken == address(0)) {
btoken = _deployBridgedToken(ctoken);
}
}
/// @dev Deploy a new BridgedERC20 contract and initialize it.
/// This must be called before the first time a bridged token is sent to
/// this chain.
/// @param ctoken CanonicalERC20 data.
/// @return btoken Address of the deployed bridged token contract.
function _deployBridgedToken(CanonicalERC20 memory ctoken) private returns (address btoken) {
bytes memory data = abi.encodeCall(
IBridgedERC20Initializable.init,
(
owner(),
addressManager,
ctoken.addr,
ctoken.chainId,
ctoken.decimals,
ctoken.symbol,
ctoken.name
)
);
btoken = address(new ERC1967Proxy(resolve(LibStrings.B_BRIDGED_ERC20, false), data));
bridgedToCanonical[btoken] = ctoken;
canonicalToBridged[ctoken.chainId][ctoken.addr] = btoken;
emit BridgedTokenDeployed({
srcChainId: ctoken.chainId,
ctoken: ctoken.addr,
btoken: btoken,
ctokenSymbol: ctoken.symbol,
ctokenName: ctoken.name,
ctokenDecimal: ctoken.decimals
});
}
function _consumeTokenQuota(address _token, uint256 _amount) private {
address quotaManager = resolve(LibStrings.B_QUOTA_MANAGER, true);
if (quotaManager != address(0)) {
IQuotaManager(quotaManager).consumeQuota(_token, _amount);
}
}
function _safeDecimals(address _token) private view returns (uint8) {
(bool success, bytes memory data) =
address(_token).staticcall(abi.encodeCall(IERC20Metadata.decimals, ()));
return success && data.length == 32 ? abi.decode(data, (uint8)) : 18;
}
}
node_modules/@openzeppelin/contracts/proxy/beacon/IBeacon.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
pragma solidity ^0.8.0;
/**
* @dev This is the interface that {BeaconProxy} expects of its beacon.
*/
interface IBeacon {
/**
* @dev Must return an address that can be used as a delegate call target.
*
* {BeaconProxy} will check that this address is a contract.
*/
function implementation() external view returns (address);
}
node_modules/@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
* https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
*
* Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
* presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
* need to send a transaction, and thus is not required to hold Ether at all.
*
* ==== Security Considerations
*
* There are two important considerations concerning the use of `permit`. The first is that a valid permit signature
* expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be
* considered as an intention to spend the allowance in any specific way. The second is that because permits have
* built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should
* take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be
* generally recommended is:
*
* ```solidity
* function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {
* try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}
* doThing(..., value);
* }
*
* function doThing(..., uint256 value) public {
* token.safeTransferFrom(msg.sender, address(this), value);
* ...
* }
* ```
*
* Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of
* `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also
* {SafeERC20-safeTransferFrom}).
*
* Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so
* contracts should have entry points that don't rely on permit.
*/
interface IERC20Permit {
/**
* @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
* given ``owner``'s signed approval.
*
* IMPORTANT: The same issues {IERC20-approve} has related to transaction
* ordering also apply here.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `deadline` must be a timestamp in the future.
* - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
* over the EIP712-formatted function arguments.
* - the signature must use ``owner``'s current nonce (see {nonces}).
*
* For more information on the signature format, see the
* https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
* section].
*
* CAUTION: See Security Considerations above.
*/
function permit(
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) external;
/**
* @dev Returns the current nonce for `owner`. This value must be
* included whenever a signature is generated for {permit}.
*
* Every successful call to {permit} increases ``owner``'s nonce by one. This
* prevents a signature from being used multiple times.
*/
function nonces(address owner) external view returns (uint256);
/**
* @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
*/
// solhint-disable-next-line func-name-mixedcase
function DOMAIN_SEPARATOR() external view returns (bytes32);
}
node_modules/@openzeppelin/contracts/utils/introspection/IERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}
contracts/common/AddressResolver.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import "./IAddressManager.sol";
import "./IAddressResolver.sol";
/// @title AddressResolver
/// @notice See the documentation in {IAddressResolver}.
/// @custom:security-contact security@taiko.xyz
abstract contract AddressResolver is IAddressResolver, Initializable {
/// @notice Address of the AddressManager.
address public addressManager;
uint256[49] private __gap;
error RESOLVER_DENIED();
error RESOLVER_INVALID_MANAGER();
error RESOLVER_UNEXPECTED_CHAINID();
error RESOLVER_ZERO_ADDR(uint64 chainId, bytes32 name);
/// @dev Modifier that ensures the caller is the resolved address of a given
/// name.
/// @param _name The name to check against.
modifier onlyFromNamed(bytes32 _name) {
if (msg.sender != resolve(_name, true)) revert RESOLVER_DENIED();
_;
}
/// @dev Modifier that ensures the caller is a resolved address to either _name1 or _name2
/// name.
/// @param _name1 The first name to check against.
/// @param _name2 The second name to check against.
modifier onlyFromNamedEither(bytes32 _name1, bytes32 _name2) {
if (msg.sender != resolve(_name1, true) && msg.sender != resolve(_name2, true)) {
revert RESOLVER_DENIED();
}
_;
}
/// @custom:oz-upgrades-unsafe-allow constructor
constructor() {
_disableInitializers();
}
/// @inheritdoc IAddressResolver
function resolve(
bytes32 _name,
bool _allowZeroAddress
)
public
view
virtual
returns (address payable)
{
return _resolve(uint64(block.chainid), _name, _allowZeroAddress);
}
/// @inheritdoc IAddressResolver
function resolve(
uint64 _chainId,
bytes32 _name,
bool _allowZeroAddress
)
public
view
virtual
returns (address payable)
{
return _resolve(_chainId, _name, _allowZeroAddress);
}
/// @dev Initialization method for setting up AddressManager reference.
/// @param _addressManager Address of the AddressManager.
function __AddressResolver_init(address _addressManager) internal virtual onlyInitializing {
if (block.chainid > type(uint64).max) {
revert RESOLVER_UNEXPECTED_CHAINID();
}
addressManager = _addressManager;
}
/// @dev Helper method to resolve name-to-address.
/// @param _chainId The chainId of interest.
/// @param _name Name whose address is to be resolved.
/// @param _allowZeroAddress If set to true, does not throw if the resolved
/// address is `address(0)`.
/// @return addr_ Address associated with the given name on the specified
/// chain.
function _resolve(
uint64 _chainId,
bytes32 _name,
bool _allowZeroAddress
)
private
view
returns (address payable addr_)
{
address _addressManager = addressManager;
if (_addressManager == address(0)) revert RESOLVER_INVALID_MANAGER();
addr_ = payable(IAddressManager(_addressManager).getAddress(_chainId, _name));
if (!_allowZeroAddress && addr_ == address(0)) {
revert RESOLVER_ZERO_ADDR(_chainId, _name);
}
}
}
node_modules/@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)
pragma solidity ^0.8.0;
import "./OwnableUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module which provides access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership} and {acceptOwnership}.
*
* This module is used through inheritance. It will make available all functions
* from parent (Ownable).
*/
abstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {
address private _pendingOwner;
event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);
function __Ownable2Step_init() internal onlyInitializing {
__Ownable_init_unchained();
}
function __Ownable2Step_init_unchained() internal onlyInitializing {
}
/**
* @dev Returns the address of the pending owner.
*/
function pendingOwner() public view virtual returns (address) {
return _pendingOwner;
}
/**
* @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual override onlyOwner {
_pendingOwner = newOwner;
emit OwnershipTransferStarted(owner(), newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual override {
delete _pendingOwner;
super._transferOwnership(newOwner);
}
/**
* @dev The new owner accepts the ownership transfer.
*/
function acceptOwnership() public virtual {
address sender = _msgSender();
require(pendingOwner() == sender, "Ownable2Step: caller is not the new owner");
_transferOwnership(sender);
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}
contracts/common/IAddressManager.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title IAddressManager
/// @notice Manages a mapping of (chainId, name) pairs to Ethereum addresses.
/// @custom:security-contact security@taiko.xyz
interface IAddressManager {
/// @notice Gets the address mapped to a specific chainId-name pair.
/// @dev Note that in production, this method shall be a pure function
/// without any storage access.
/// @param _chainId The chainId for which the address needs to be fetched.
/// @param _name The name for which the address needs to be fetched.
/// @return Address associated with the chainId-name pair.
function getAddress(uint64 _chainId, bytes32 _name) external view returns (address);
}
node_modules/@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (proxy/ERC1967/ERC1967Proxy.sol)
pragma solidity ^0.8.0;
import "../Proxy.sol";
import "./ERC1967Upgrade.sol";
/**
* @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
* implementation address that can be changed. This address is stored in storage in the location specified by
* https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
* implementation behind the proxy.
*/
contract ERC1967Proxy is Proxy, ERC1967Upgrade {
/**
* @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
*
* If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
* function call, and allows initializing the storage of the proxy like a Solidity constructor.
*/
constructor(address _logic, bytes memory _data) payable {
_upgradeToAndCall(_logic, _data, false);
}
/**
* @dev Returns the current implementation address.
*/
function _implementation() internal view virtual override returns (address impl) {
return ERC1967Upgrade._getImplementation();
}
}
node_modules/@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
import "../extensions/IERC20Permit.sol";
import "../../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using Address for address;
/**
* @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeTransfer(IERC20 token, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
/**
* @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
* calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
*/
function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(IERC20 token, address spender, uint256 value) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
/**
* @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 oldAllowance = token.allowance(address(this), spender);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));
}
/**
* @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));
}
}
/**
* @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval
* to be set to zero before setting it to a non-zero value, such as USDT.
*/
function forceApprove(IERC20 token, address spender, uint256 value) internal {
bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);
if (!_callOptionalReturnBool(token, approvalCall)) {
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));
_callOptionalReturn(token, approvalCall);
}
}
/**
* @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.
* Revert on invalid signature.
*/
function safePermit(
IERC20Permit token,
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) internal {
uint256 nonceBefore = token.nonces(owner);
token.permit(owner, spender, value, deadline, v, r, s);
uint256 nonceAfter = token.nonces(owner);
require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
require(returndata.length == 0 || abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*
* This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.
*/
function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false
// and not revert is the subcall reverts.
(bool success, bytes memory returndata) = address(token).call(data);
return
success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));
}
}
contracts/libs/LibNetwork.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title LibNetwork
library LibNetwork {
uint256 internal constant MAINNET = 1;
uint256 internal constant ROPSTEN = 2;
uint256 internal constant RINKEBY = 4;
uint256 internal constant GOERLI = 5;
uint256 internal constant KOVAN = 42;
uint256 internal constant HOLESKY = 17_000;
uint256 internal constant SEPOLIA = 11_155_111;
uint64 internal constant TAIKO = 167_000;
/// @dev Checks if the chain ID represents an Ethereum testnet.
/// @param _chainId The chain ID.
/// @return true if the chain ID represents an Ethereum testnet, false otherwise.
function isEthereumTestnet(uint256 _chainId) internal pure returns (bool) {
return _chainId == LibNetwork.ROPSTEN || _chainId == LibNetwork.RINKEBY
|| _chainId == LibNetwork.GOERLI || _chainId == LibNetwork.KOVAN
|| _chainId == LibNetwork.HOLESKY || _chainId == LibNetwork.SEPOLIA;
}
/// @dev Checks if the chain ID represents an Ethereum testnet or the Etheruem mainnet.
/// @param _chainId The chain ID.
/// @return true if the chain ID represents an Ethereum testnet or the Etheruem mainnet, false
/// otherwise.
function isEthereumMainnetOrTestnet(uint256 _chainId) internal pure returns (bool) {
return _chainId == LibNetwork.MAINNET || isEthereumTestnet(_chainId);
}
/// @dev Checks if the chain ID represents the Taiko L2 mainnet.
/// @param _chainId The chain ID.
/// @return true if the chain ID represents the Taiko L2 mainnet.
function isTaikoMainnet(uint256 _chainId) internal pure returns (bool) {
return _chainId == TAIKO;
}
/// @dev Checks if the chain ID represents an internal Taiko devnet's base layer.
/// @param _chainId The chain ID.
/// @return true if the chain ID represents an internal Taiko devnet's base layer, false
/// otherwise.
function isTaikoDevnet(uint256 _chainId) internal pure returns (bool) {
return _chainId >= 32_300 && _chainId <= 32_400;
}
/// @dev Checks if the chain supports Dencun hardfork. Note that this check doesn't need to be
/// exhaustive.
/// @param _chainId The chain ID.
/// @return true if the chain supports Dencun hardfork, false otherwise.
function isDencunSupported(uint256 _chainId) internal pure returns (bool) {
return _chainId == LibNetwork.MAINNET || _chainId == LibNetwork.HOLESKY
|| _chainId == LibNetwork.SEPOLIA || isTaikoDevnet(_chainId);
}
}
contracts/tokenvault/BaseVault.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import "@openzeppelin/contracts-upgradeable/utils/introspection/IERC165Upgradeable.sol";
import "@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol";
import "../bridge/IBridge.sol";
import "../common/EssentialContract.sol";
import "../common/LibStrings.sol";
import "../libs/LibBytes.sol";
/// @title INameSymbol
/// @notice Interface for contracts that provide name() and symbol()
/// functions. These functions may not be part of the official interface but are
/// used by some contracts.
/// @custom:security-contact security@taiko.xyz
interface INameSymbol {
function name() external view returns (string memory);
function symbol() external view returns (string memory);
}
/// @title BaseVault
/// @notice This abstract contract provides a base implementation for vaults.
/// @custom:security-contact security@taiko.xyz
abstract contract BaseVault is
EssentialContract,
IRecallableSender,
IMessageInvocable,
IERC165Upgradeable
{
using LibBytes for bytes;
uint256[50] private __gap;
error VAULT_INVALID_TO_ADDR();
error VAULT_PERMISSION_DENIED();
/// @notice Checks if the contract supports the given interface.
/// @param _interfaceId The interface identifier.
/// @return true if the contract supports the interface, false otherwise.
function supportsInterface(bytes4 _interfaceId) public view virtual override returns (bool) {
return _interfaceId == type(IRecallableSender).interfaceId
|| _interfaceId == type(IMessageInvocable).interfaceId
|| _interfaceId == type(IERC165Upgradeable).interfaceId;
}
/// @notice Returns the name of the vault.
/// @return The name of the vault.
function name() public pure virtual returns (bytes32);
function checkProcessMessageContext()
internal
view
onlyFromNamed(LibStrings.B_BRIDGE)
returns (IBridge.Context memory ctx_)
{
ctx_ = IBridge(msg.sender).context();
address selfOnSourceChain = resolve(ctx_.srcChainId, name(), false);
if (ctx_.from != selfOnSourceChain) revert VAULT_PERMISSION_DENIED();
}
function checkRecallMessageContext()
internal
view
onlyFromNamed(LibStrings.B_BRIDGE)
returns (IBridge.Context memory ctx_)
{
ctx_ = IBridge(msg.sender).context();
if (ctx_.from != msg.sender) revert VAULT_PERMISSION_DENIED();
}
function checkToAddress(address _to) internal view {
if (_to == address(0) || _to == address(this)) revert VAULT_INVALID_TO_ADDR();
}
function safeSymbol(address _token) internal view returns (string memory symbol_) {
(bool success, bytes memory data) =
address(_token).staticcall(abi.encodeCall(INameSymbol.symbol, ()));
return success ? data.toString() : "";
}
function safeName(address _token) internal view returns (string memory) {
(bool success, bytes memory data) =
address(_token).staticcall(abi.encodeCall(INameSymbol.name, ()));
return success ? data.toString() : "";
}
}
node_modules/@openzeppelin/contracts-upgradeable/utils/introspection/IERC165Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165Upgradeable {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}
node_modules/@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)
pragma solidity ^0.8.0;
import "../../interfaces/draft-IERC1822.sol";
import "../ERC1967/ERC1967Upgrade.sol";
/**
* @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
* {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
*
* A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
* reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
* `UUPSUpgradeable` with a custom implementation of upgrades.
*
* The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
*
* _Available since v4.1._
*/
abstract contract UUPSUpgradeable is IERC1822Proxiable, ERC1967Upgrade {
/// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
address private immutable __self = address(this);
/**
* @dev Check that the execution is being performed through a delegatecall call and that the execution context is
* a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
* for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
* function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
* fail.
*/
modifier onlyProxy() {
require(address(this) != __self, "Function must be called through delegatecall");
require(_getImplementation() == __self, "Function must be called through active proxy");
_;
}
/**
* @dev Check that the execution is not being performed through a delegate call. This allows a function to be
* callable on the implementing contract but not through proxies.
*/
modifier notDelegated() {
require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall");
_;
}
/**
* @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
* implementation. It is used to validate the implementation's compatibility when performing an upgrade.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
*/
function proxiableUUID() external view virtual override notDelegated returns (bytes32) {
return _IMPLEMENTATION_SLOT;
}
/**
* @dev Upgrade the implementation of the proxy to `newImplementation`.
*
* Calls {_authorizeUpgrade}.
*
* Emits an {Upgraded} event.
*
* @custom:oz-upgrades-unsafe-allow-reachable delegatecall
*/
function upgradeTo(address newImplementation) public virtual onlyProxy {
_authorizeUpgrade(newImplementation);
_upgradeToAndCallUUPS(newImplementation, new bytes(0), false);
}
/**
* @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
* encoded in `data`.
*
* Calls {_authorizeUpgrade}.
*
* Emits an {Upgraded} event.
*
* @custom:oz-upgrades-unsafe-allow-reachable delegatecall
*/
function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
_authorizeUpgrade(newImplementation);
_upgradeToAndCallUUPS(newImplementation, data, true);
}
/**
* @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
* {upgradeTo} and {upgradeToAndCall}.
*
* Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
*
* ```solidity
* function _authorizeUpgrade(address) internal override onlyOwner {}
* ```
*/
function _authorizeUpgrade(address newImplementation) internal virtual;
}
contracts/tokenvault/IBridgedERC20.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title IBridgedERC20
/// @notice Interface for all bridged tokens.
/// @dev To facilitate compatibility with third-party bridged tokens, such as USDC's native
/// standard, it's necessary to implement an intermediary adapter contract which should conform to
/// this interface, enabling effective interaction with third-party contracts.
/// @custom:security-contact security@taiko.xyz
interface IBridgedERC20 {
/// @notice Mints `amount` tokens and assigns them to the `account` address.
/// @param _account The account to receive the minted tokens.
/// @param _amount The amount of tokens to mint.
function mint(address _account, uint256 _amount) external;
/// @notice Burns tokens from msg.sender. This is only allowed if:
/// - 1) tokens are migrating out to a new bridged token
/// - 2) The token is burned by ERC20Vault to bridge back to the canonical chain.
/// @param _amount The amount of tokens to burn.
function burn(uint256 _amount) external;
/// @notice Gets the canonical token's address and chain ID.
/// @return The canonical token's address.
/// @return The canonical token's chain ID.
function canonical() external view returns (address, uint256);
}
/// @title IBridgedERC20Migratable
/// @custom:security-contact security@taiko.xyz
interface IBridgedERC20Migratable {
/// @notice Starts or stops migration to/from a specified contract.
/// @param _addr The address migrating 'to' or 'from'.
/// @param _inbound If false then signals migrating 'from', true if migrating 'into'.
function changeMigrationStatus(address _addr, bool _inbound) external;
}
/// @title IBridgedERC20Initializable
/// @custom:security-contact security@taiko.xyz
interface IBridgedERC20Initializable {
/// @notice Initializes the contract.
/// @param _owner The owner of this contract. msg.sender will be used if this value is zero.
/// @param _addressManager The address of the {AddressManager} contract.
/// @param _srcToken The source token address.
/// @param _srcChainId The source chain ID.
/// @param _decimals The number of decimal places of the source token.
/// @param _symbol The symbol of the token.
/// @param _name The name of the token.
function init(
address _owner,
address _addressManager,
address _srcToken,
uint256 _srcChainId,
uint8 _decimals,
string calldata _symbol,
string calldata _name
)
external;
}
contracts/libs/LibBytes.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
library LibBytes {
error INNER_ERROR(bytes innerError);
// Taken from:
// https://github.com/0xPolygonHermez/zkevm-contracts/blob/main/contracts/PolygonZkEVMBridge.sol#L835-L860
/// @notice Function to convert returned data to string
/// returns 'NOT_VALID_ENCODING' as fallback value.
function toString(bytes memory _data) internal pure returns (string memory) {
if (_data.length >= 64) {
return abi.decode(_data, (string));
} else if (_data.length == 32) {
// Since the strings on bytes32 are encoded left-right, check the first zero in the data
uint256 nonZeroBytes;
while (nonZeroBytes < 32 && _data[nonZeroBytes] != 0) {
++nonZeroBytes;
}
// If the first one is 0, we do not handle the encoding
if (nonZeroBytes == 0) return "";
// Create a byte array with nonZeroBytes length
bytes memory bytesArray = new bytes(nonZeroBytes);
for (uint256 i; i < nonZeroBytes; ++i) {
bytesArray[i] = _data[i];
}
return string(bytesArray);
} else {
return "";
}
}
// Taken from:
// https://github.com/boringcrypto/BoringSolidity/blob/master/contracts/BoringBatchable.sol
/// @dev Helper function to extract a useful revert message from a failed call.
/// If the returned data is malformed or not correctly abi encoded then this call can fail
/// itself.
function revertWithExtractedError(bytes memory _returnData) internal pure {
// If the _res length is less than 68, then
// the transaction failed with custom error or silently (without a revert message)
if (_returnData.length < 68) revert INNER_ERROR(_returnData);
assembly {
// Slice the sighash.
_returnData := add(_returnData, 0x04)
}
revert(abi.decode(_returnData, (string))); // All that remains is the revert string
}
}
node_modules/@openzeppelin/contracts/proxy/ERC1967/ERC1967Upgrade.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)
pragma solidity ^0.8.2;
import "../beacon/IBeacon.sol";
import "../../interfaces/IERC1967.sol";
import "../../interfaces/draft-IERC1822.sol";
import "../../utils/Address.sol";
import "../../utils/StorageSlot.sol";
/**
* @dev This abstract contract provides getters and event emitting update functions for
* https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
*
* _Available since v4.1._
*/
abstract contract ERC1967Upgrade is IERC1967 {
// This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
/**
* @dev Storage slot with the address of the current implementation.
* This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
* validated in the constructor.
*/
bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
/**
* @dev Returns the current implementation address.
*/
function _getImplementation() internal view returns (address) {
return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 implementation slot.
*/
function _setImplementation(address newImplementation) private {
require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
}
/**
* @dev Perform implementation upgrade
*
* Emits an {Upgraded} event.
*/
function _upgradeTo(address newImplementation) internal {
_setImplementation(newImplementation);
emit Upgraded(newImplementation);
}
/**
* @dev Perform implementation upgrade with additional setup call.
*
* Emits an {Upgraded} event.
*/
function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
_upgradeTo(newImplementation);
if (data.length > 0 || forceCall) {
Address.functionDelegateCall(newImplementation, data);
}
}
/**
* @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
*
* Emits an {Upgraded} event.
*/
function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
// Upgrades from old implementations will perform a rollback test. This test requires the new
// implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
// this special case will break upgrade paths from old UUPS implementation to new ones.
if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
_setImplementation(newImplementation);
} else {
try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
} catch {
revert("ERC1967Upgrade: new implementation is not UUPS");
}
_upgradeToAndCall(newImplementation, data, forceCall);
}
}
/**
* @dev Storage slot with the admin of the contract.
* This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
* validated in the constructor.
*/
bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
/**
* @dev Returns the current admin.
*/
function _getAdmin() internal view returns (address) {
return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 admin slot.
*/
function _setAdmin(address newAdmin) private {
require(newAdmin != address(0), "ERC1967: new admin is the zero address");
StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
}
/**
* @dev Changes the admin of the proxy.
*
* Emits an {AdminChanged} event.
*/
function _changeAdmin(address newAdmin) internal {
emit AdminChanged(_getAdmin(), newAdmin);
_setAdmin(newAdmin);
}
/**
* @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
* This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
*/
bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
/**
* @dev Returns the current beacon.
*/
function _getBeacon() internal view returns (address) {
return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
}
/**
* @dev Stores a new beacon in the EIP1967 beacon slot.
*/
function _setBeacon(address newBeacon) private {
require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
require(
Address.isContract(IBeacon(newBeacon).implementation()),
"ERC1967: beacon implementation is not a contract"
);
StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
}
/**
* @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
* not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
*
* Emits a {BeaconUpgraded} event.
*/
function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
_setBeacon(newBeacon);
emit BeaconUpgraded(newBeacon);
if (data.length > 0 || forceCall) {
Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
}
}
}
node_modules/@openzeppelin/contracts/interfaces/IERC1967.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)
pragma solidity ^0.8.0;
/**
* @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
*
* _Available since v4.8.3._
*/
interface IERC1967 {
/**
* @dev Emitted when the implementation is upgraded.
*/
event Upgraded(address indexed implementation);
/**
* @dev Emitted when the admin account has changed.
*/
event AdminChanged(address previousAdmin, address newAdmin);
/**
* @dev Emitted when the beacon is changed.
*/
event BeaconUpgraded(address indexed beacon);
}
contracts/bridge/IBridge.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title IBridge
/// @notice The bridge used in conjunction with the {ISignalService}.
/// @dev Ether is held by Bridges on L1 and L2s.
/// @custom:security-contact security@taiko.xyz
interface IBridge {
enum Status {
NEW,
RETRIABLE,
DONE,
FAILED,
RECALLED
}
enum StatusReason {
INVOCATION_OK,
INVOCATION_PROHIBITED,
INVOCATION_FAILED,
OUT_OF_ETH_QUOTA
}
struct Message {
// Message ID whose value is automatically assigned.
uint64 id;
// The max processing fee for the relayer. This fee has 3 parts:
// - the fee for message calldata.
// - the minimal fee reserve for general processing, excluding function call.
// - the invocation fee for the function call.
// Any unpaid fee will be refunded to the destOwner on the destination chain.
// Note that fee must be 0 if gasLimit is 0, or large enough to make the invocation fee
// non-zero.
uint64 fee;
// gasLimit that the processMessage call must have.
uint32 gasLimit;
// The address, EOA or contract, that interacts with this bridge.
// The value is automatically assigned.
address from;
// Source chain ID whose value is automatically assigned.
uint64 srcChainId;
// The owner of the message on the source chain.
address srcOwner;
// Destination chain ID where the `to` address lives.
uint64 destChainId;
// The owner of the message on the destination chain.
address destOwner;
// The destination address on the destination chain.
address to;
// value to invoke on the destination chain.
uint256 value;
// callData to invoke on the destination chain.
bytes data;
}
// Struct representing the context of a bridge operation.
// 2 slots
struct Context {
bytes32 msgHash; // Message hash.
address from; // Sender's address.
uint64 srcChainId; // Source chain ID.
}
/// @notice Emitted when a message is sent.
/// @param msgHash The hash of the message.
/// @param message The message.
event MessageSent(bytes32 indexed msgHash, Message message);
/// @notice Emitted when the status of a message changes.
/// @param msgHash The hash of the message.
/// @param status The new status of the message.
event MessageStatusChanged(bytes32 indexed msgHash, Status status);
/// @notice Sends a message to the destination chain and takes custody
/// of Ether required in this contract.
/// @param _message The message to be sent.
/// @return msgHash_ The hash of the sent message.
/// @return message_ The updated message sent.
function sendMessage(Message calldata _message)
external
payable
returns (bytes32 msgHash_, Message memory message_);
/// @notice Recalls a failed message on its source chain, releasing
/// associated assets.
/// @dev This function checks if the message failed on the source chain and
/// releases associated Ether or tokens.
/// @param _message The message whose associated Ether should be released.
/// @param _proof The merkle inclusion proof.
function recallMessage(Message calldata _message, bytes calldata _proof) external;
/// @notice Processes a bridge message on the destination chain. This
/// function is callable by any address, including the `message.destOwner`.
/// @dev The process begins by hashing the message and checking the message
/// status in the bridge If the status is "NEW", the message is invoked. The
/// status is updated accordingly, and processing fees are refunded as
/// needed.
/// @param _message The message to be processed.
/// @param _proof The merkle inclusion proof.
/// @return The message's status after processing and the reason for the change.
function processMessage(
Message calldata _message,
bytes calldata _proof
)
external
returns (Status, StatusReason);
/// @notice Retries to invoke the messageCall after releasing associated
/// Ether and tokens.
/// @dev This function can be called by any address, including the
/// `message.destOwner`.
/// It attempts to invoke the messageCall and updates the message status
/// accordingly.
/// @param _message The message to retry.
/// @param _isLastAttempt Specifies if this is the last attempt to retry the
/// message.
function retryMessage(Message calldata _message, bool _isLastAttempt) external;
/// @notice Mark a message as failed if the message is currently retriable.
/// @dev This function can only be called by `message.destOwner`.
/// @param _message The message to fail.
/// message.
function failMessage(Message calldata _message) external;
/// @notice Returns the bridge state context.
/// @return ctx_ The context of the current bridge operation.
function context() external view returns (Context memory ctx_);
/// @notice Checks if the message was sent.
/// @param _message The message.
/// @return true if the message was sent.
function isMessageSent(Message calldata _message) external view returns (bool);
/// @notice Hash the message
/// @param _message The message struct variable to be hashed.
/// @return The message's hash.
function hashMessage(Message memory _message) external pure returns (bytes32);
}
/// @title IRecallableSender
/// @notice An interface that all recallable message senders shall implement.
interface IRecallableSender {
/// @notice Called when a message is recalled.
/// @param _message The recalled message.
/// @param _msgHash The hash of the recalled message.
function onMessageRecalled(
IBridge.Message calldata _message,
bytes32 _msgHash
)
external
payable;
}
/// @title IMessageInvocable
/// @notice An interface that all bridge message receiver shall implement
interface IMessageInvocable {
/// @notice Called when this contract is the bridge target.
/// @param _data The data for this contract to interpret.
/// @dev This method should be guarded with `onlyFromNamed("bridge")`.
function onMessageInvocation(bytes calldata _data) external payable;
}
node_modules/@openzeppelin/contracts/interfaces/IERC1271.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC1271 standard signature validation method for
* contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
*
* _Available since v4.1._
*/
interface IERC1271 {
/**
* @dev Should return whether the signature provided is valid for the provided data
* @param hash Hash of the data to be signed
* @param signature Signature byte array associated with _data
*/
function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
}
contracts/common/IAddressResolver.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title IAddressResolver
/// @notice This contract acts as a bridge for name-to-address resolution.
/// It delegates the resolution to the AddressManager. By separating the logic,
/// we can maintain flexibility in address management without affecting the
/// resolving process.
/// @dev Note that the address manager should be changed using upgradability, there
/// is no setAddressManager() function to guarantee atomicity across all
/// contracts that are resolvers.
/// @custom:security-contact security@taiko.xyz
interface IAddressResolver {
/// @notice Resolves a name to its address deployed on this chain.
/// @param _name Name whose address is to be resolved.
/// @param _allowZeroAddress If set to true, does not throw if the resolved
/// address is `address(0)`.
/// @return Address associated with the given name.
function resolve(
bytes32 _name,
bool _allowZeroAddress
)
external
view
returns (address payable);
/// @notice Resolves a name to its address deployed on a specified chain.
/// @param _chainId The chainId of interest.
/// @param _name Name whose address is to be resolved.
/// @param _allowZeroAddress If set to true, does not throw if the resolved
/// address is `address(0)`.
/// @return Address associated with the given name on the specified
/// chain.
function resolve(
uint64 _chainId,
bytes32 _name,
bool _allowZeroAddress
)
external
view
returns (address payable);
}
node_modules/@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
pragma solidity ^0.8.0;
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract ContextUpgradeable is Initializable {
function __Context_init() internal onlyInitializing {
}
function __Context_init_unchained() internal onlyInitializing {
}
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[50] private __gap;
}
contracts/libs/LibAddress.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import "@openzeppelin/contracts/utils/Address.sol";
import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
import "@openzeppelin/contracts/interfaces/IERC1271.sol";
/// @title LibAddress
/// @dev Provides utilities for address-related operations.
/// @custom:security-contact security@taiko.xyz
library LibAddress {
error ETH_TRANSFER_FAILED();
/// @dev Sends Ether to the specified address. This method will not revert even if sending ether
/// fails.
/// This function is inspired by
/// https://github.com/nomad-xyz/ExcessivelySafeCall/blob/main/src/ExcessivelySafeCall.sol
/// @param _to The recipient address.
/// @param _amount The amount of Ether to send in wei.
/// @param _gasLimit The max amount gas to pay for this transaction.
/// @return success_ true if the call is successful, false otherwise.
function sendEther(
address _to,
uint256 _amount,
uint256 _gasLimit,
bytes memory _calldata
)
internal
returns (bool success_)
{
// Check for zero-address transactions
if (_to == address(0)) revert ETH_TRANSFER_FAILED();
// dispatch message to recipient
// by assembly calling "handle" function
// we call via assembly to avoid memcopying a very large returndata
// returned by a malicious contract
assembly {
success_ :=
call(
_gasLimit, // gas
_to, // recipient
_amount, // ether value
add(_calldata, 0x20), // inloc
mload(_calldata), // inlen
0, // outloc
0 // outlen
)
}
}
/// @dev Sends Ether to the specified address. This method will revert if sending ether fails.
/// @param _to The recipient address.
/// @param _amount The amount of Ether to send in wei.
/// @param _gasLimit The max amount gas to pay for this transaction.
function sendEtherAndVerify(address _to, uint256 _amount, uint256 _gasLimit) internal {
if (_amount == 0) return;
if (!sendEther(_to, _amount, _gasLimit, "")) {
revert ETH_TRANSFER_FAILED();
}
}
/// @dev Sends Ether to the specified address. This method will revert if sending ether fails.
/// @param _to The recipient address.
/// @param _amount The amount of Ether to send in wei.
function sendEtherAndVerify(address _to, uint256 _amount) internal {
sendEtherAndVerify(_to, _amount, gasleft());
}
function supportsInterface(
address _addr,
bytes4 _interfaceId
)
internal
view
returns (bool result_)
{
if (!Address.isContract(_addr)) return false;
try IERC165(_addr).supportsInterface(_interfaceId) returns (bool _result) {
result_ = _result;
} catch { }
}
}
node_modules/@openzeppelin/contracts/utils/StorageSlot.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
pragma solidity ^0.8.0;
/**
* @dev Library for reading and writing primitive types to specific storage slots.
*
* Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
* This library helps with reading and writing to such slots without the need for inline assembly.
*
* The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
*
* Example usage to set ERC1967 implementation slot:
* ```solidity
* contract ERC1967 {
* bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
*
* function _getImplementation() internal view returns (address) {
* return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
* }
*
* function _setImplementation(address newImplementation) internal {
* require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
* StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
* }
* }
* ```
*
* _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
* _Available since v4.9 for `string`, `bytes`._
*/
library StorageSlot {
struct AddressSlot {
address value;
}
struct BooleanSlot {
bool value;
}
struct Bytes32Slot {
bytes32 value;
}
struct Uint256Slot {
uint256 value;
}
struct StringSlot {
string value;
}
struct BytesSlot {
bytes value;
}
/**
* @dev Returns an `AddressSlot` with member `value` located at `slot`.
*/
function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BooleanSlot` with member `value` located at `slot`.
*/
function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
*/
function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Uint256Slot` with member `value` located at `slot`.
*/
function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` with member `value` located at `slot`.
*/
function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` representation of the string storage pointer `store`.
*/
function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
/**
* @dev Returns an `BytesSlot` with member `value` located at `slot`.
*/
function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
*/
function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
}
node_modules/@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*
* _Available since v4.1._
*/
interface IERC20Metadata is IERC20 {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}
contracts/common/LibStrings.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title LibStrings
/// @custom:security-contact security@taiko.xyz
library LibStrings {
bytes32 internal constant B_ASSIGNMENT_HOOK = bytes32("assignment_hook");
bytes32 internal constant B_AUTOMATA_DCAP_ATTESTATION = bytes32("automata_dcap_attestation");
bytes32 internal constant B_BRIDGE = bytes32("bridge");
bytes32 internal constant B_BRIDGE_WATCHDOG = bytes32("bridge_watchdog");
bytes32 internal constant B_BRIDGED_ERC1155 = bytes32("bridged_erc1155");
bytes32 internal constant B_BRIDGED_ERC20 = bytes32("bridged_erc20");
bytes32 internal constant B_BRIDGED_ERC721 = bytes32("bridged_erc721");
bytes32 internal constant B_CHAIN_WATCHDOG = bytes32("chain_watchdog");
bytes32 internal constant B_ERC1155_VAULT = bytes32("erc1155_vault");
bytes32 internal constant B_ERC20_VAULT = bytes32("erc20_vault");
bytes32 internal constant B_ERC721_VAULT = bytes32("erc721_vault");
bytes32 internal constant B_PROPOSER = bytes32("proposer");
bytes32 internal constant B_PROPOSER_ONE = bytes32("proposer_one");
bytes32 internal constant B_PROVER_ASSIGNMENT = bytes32("PROVER_ASSIGNMENT");
bytes32 internal constant B_PROVER_SET = bytes32("prover_set");
bytes32 internal constant B_QUOTA_MANAGER = bytes32("quota_manager");
bytes32 internal constant B_SGX_WATCHDOG = bytes32("sgx_watchdog");
bytes32 internal constant B_SIGNAL_SERVICE = bytes32("signal_service");
bytes32 internal constant B_TAIKO = bytes32("taiko");
bytes32 internal constant B_TAIKO_TOKEN = bytes32("taiko_token");
bytes32 internal constant B_TIER_GUARDIAN = bytes32("tier_guardian");
bytes32 internal constant B_TIER_GUARDIAN_MINORITY = bytes32("tier_guardian_minority");
bytes32 internal constant B_TIER_PROVIDER = bytes32("tier_provider");
bytes32 internal constant B_TIER_SGX = bytes32("tier_sgx");
bytes32 internal constant B_TIER_SGX_ZKVM = bytes32("tier_sgx_zkvm");
bytes32 internal constant B_WITHDRAWER = bytes32("withdrawer");
bytes32 internal constant H_RETURN_LIVENESS_BOND = keccak256("RETURN_LIVENESS_BOND");
bytes32 internal constant H_SIGNAL_ROOT = keccak256("SIGNAL_ROOT");
bytes32 internal constant H_STATE_ROOT = keccak256("STATE_ROOT");
}
node_modules/@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)
pragma solidity ^0.8.2;
import "../../utils/AddressUpgradeable.sol";
/**
* @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
* behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
* external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
* function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
*
* The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
* reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
* case an upgrade adds a module that needs to be initialized.
*
* For example:
*
* [.hljs-theme-light.nopadding]
* ```solidity
* contract MyToken is ERC20Upgradeable {
* function initialize() initializer public {
* __ERC20_init("MyToken", "MTK");
* }
* }
*
* contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
* function initializeV2() reinitializer(2) public {
* __ERC20Permit_init("MyToken");
* }
* }
* ```
*
* TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
* possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
*
* CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
* that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
*
* [CAUTION]
* ====
* Avoid leaving a contract uninitialized.
*
* An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
* contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
* the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
*
* [.hljs-theme-light.nopadding]
* ```
* /// @custom:oz-upgrades-unsafe-allow constructor
* constructor() {
* _disableInitializers();
* }
* ```
* ====
*/
abstract contract Initializable {
/**
* @dev Indicates that the contract has been initialized.
* @custom:oz-retyped-from bool
*/
uint8 private _initialized;
/**
* @dev Indicates that the contract is in the process of being initialized.
*/
bool private _initializing;
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint8 version);
/**
* @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
* `onlyInitializing` functions can be used to initialize parent contracts.
*
* Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
* constructor.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
bool isTopLevelCall = !_initializing;
require(
(isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
"Initializable: contract is already initialized"
);
_initialized = 1;
if (isTopLevelCall) {
_initializing = true;
}
_;
if (isTopLevelCall) {
_initializing = false;
emit Initialized(1);
}
}
/**
* @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
* contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
* used to initialize parent contracts.
*
* A reinitializer may be used after the original initialization step. This is essential to configure modules that
* are added through upgrades and that require initialization.
*
* When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
* cannot be nested. If one is invoked in the context of another, execution will revert.
*
* Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
* a contract, executing them in the right order is up to the developer or operator.
*
* WARNING: setting the version to 255 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint8 version) {
require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
_initialized = version;
_initializing = true;
_;
_initializing = false;
emit Initialized(version);
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} and {reinitializer} modifiers, directly or indirectly.
*/
modifier onlyInitializing() {
require(_initializing, "Initializable: contract is not initializing");
_;
}
/**
* @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
* Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
* to any version. It is recommended to use this to lock implementation contracts that are designed to be called
* through proxies.
*
* Emits an {Initialized} event the first time it is successfully executed.
*/
function _disableInitializers() internal virtual {
require(!_initializing, "Initializable: contract is initializing");
if (_initialized != type(uint8).max) {
_initialized = type(uint8).max;
emit Initialized(type(uint8).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint8) {
return _initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _initializing;
}
}
node_modules/@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import "../utils/ContextUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
function __Ownable_init() internal onlyInitializing {
__Ownable_init_unchained();
}
function __Ownable_init_unchained() internal onlyInitializing {
_transferOwnership(_msgSender());
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
require(newOwner != address(0), "Ownable: new owner is the zero address");
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}
node_modules/@openzeppelin/contracts/interfaces/draft-IERC1822.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
pragma solidity ^0.8.0;
/**
* @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
* proxy whose upgrades are fully controlled by the current implementation.
*/
interface IERC1822Proxiable {
/**
* @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
* address.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy.
*/
function proxiableUUID() external view returns (bytes32);
}
node_modules/@openzeppelin/contracts/utils/Address.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
node_modules/@openzeppelin/contracts/token/ERC20/IERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 amount) external returns (bool);
}
node_modules/@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library AddressUpgradeable {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
contracts/bridge/IQuotaManager.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
/// @title IQuotaManager
/// @custom:security-contact security@taiko.xyz
interface IQuotaManager {
/// @notice Consumes a specific amount of quota for a given address.
/// This function must revert if available quota is smaller than the given amount of quota.
///
/// @dev Note that IQuotaManager is used by vaults and bridge, and should be registered in a
/// shared address manager on the L1, therefore, a registered IQuotaManager and its per-token
/// quota settings will be shared by all Taiko L2s. To enable a per-L2 quota, we need to modify
/// this function to:
/// `function consumeQuota(uint256 _srcChainId, address _token, uint256 _amount) `
///
/// @param _token The token address. Ether is represented with address(0).
/// @param _amount The amount of quota to consume.
function consumeQuota(address _token, uint256 _amount) external;
}
node_modules/@openzeppelin/contracts/proxy/Proxy.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol)
pragma solidity ^0.8.0;
/**
* @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
* instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
* be specified by overriding the virtual {_implementation} function.
*
* Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
* different contract through the {_delegate} function.
*
* The success and return data of the delegated call will be returned back to the caller of the proxy.
*/
abstract contract Proxy {
/**
* @dev Delegates the current call to `implementation`.
*
* This function does not return to its internal call site, it will return directly to the external caller.
*/
function _delegate(address implementation) internal virtual {
assembly {
// Copy msg.data. We take full control of memory in this inline assembly
// block because it will not return to Solidity code. We overwrite the
// Solidity scratch pad at memory position 0.
calldatacopy(0, 0, calldatasize())
// Call the implementation.
// out and outsize are 0 because we don't know the size yet.
let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
// Copy the returned data.
returndatacopy(0, 0, returndatasize())
switch result
// delegatecall returns 0 on error.
case 0 {
revert(0, returndatasize())
}
default {
return(0, returndatasize())
}
}
}
/**
* @dev This is a virtual function that should be overridden so it returns the address to which the fallback function
* and {_fallback} should delegate.
*/
function _implementation() internal view virtual returns (address);
/**
* @dev Delegates the current call to the address returned by `_implementation()`.
*
* This function does not return to its internal call site, it will return directly to the external caller.
*/
function _fallback() internal virtual {
_beforeFallback();
_delegate(_implementation());
}
/**
* @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
* function in the contract matches the call data.
*/
fallback() external payable virtual {
_fallback();
}
/**
* @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
* is empty.
*/
receive() external payable virtual {
_fallback();
}
/**
* @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
* call, or as part of the Solidity `fallback` or `receive` functions.
*
* If overridden should call `super._beforeFallback()`.
*/
function _beforeFallback() internal virtual {}
}
contracts/common/EssentialContract.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import "@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol";
import "./AddressResolver.sol";
import "../libs/LibNetwork.sol";
/// @title EssentialContract
/// @custom:security-contact security@taiko.xyz
abstract contract EssentialContract is UUPSUpgradeable, Ownable2StepUpgradeable, AddressResolver {
uint8 private constant _FALSE = 1;
uint8 private constant _TRUE = 2;
/// @dev The slot in transient storage of the reentry lock.
/// This is the result of keccak256("ownerUUPS.reentry_slot") plus 1. The addition aims to
/// prevent hash collisions with slots defined in EIP-1967, where slots are derived by
/// keccak256("something") - 1, and with slots in SignalService, calculated directly with
/// keccak256("something").
bytes32 private constant _REENTRY_SLOT =
0xa5054f728453d3dbe953bdc43e4d0cb97e662ea32d7958190f3dc2da31d9721b;
/// @dev Slot 1.
uint8 private __reentry;
uint8 private __paused;
uint64 public lastUnpausedAt;
uint256[49] private __gap;
/// @notice Emitted when the contract is paused.
/// @param account The account that paused the contract.
event Paused(address account);
/// @notice Emitted when the contract is unpaused.
/// @param account The account that unpaused the contract.
event Unpaused(address account);
error INVALID_PAUSE_STATUS();
error FUNC_NOT_IMPLEMENTED();
error REENTRANT_CALL();
error ZERO_ADDRESS();
error ZERO_VALUE();
/// @dev Modifier that ensures the caller is the owner or resolved address of a given name.
/// @param _name The name to check against.
modifier onlyFromOwnerOrNamed(bytes32 _name) {
if (msg.sender != owner() && msg.sender != resolve(_name, true)) revert RESOLVER_DENIED();
_;
}
modifier notImplemented() {
revert FUNC_NOT_IMPLEMENTED();
_;
}
modifier nonReentrant() {
if (_loadReentryLock() == _TRUE) revert REENTRANT_CALL();
_storeReentryLock(_TRUE);
_;
_storeReentryLock(_FALSE);
}
modifier whenPaused() {
if (!paused()) revert INVALID_PAUSE_STATUS();
_;
}
modifier whenNotPaused() {
if (paused()) revert INVALID_PAUSE_STATUS();
_;
}
modifier nonZeroAddr(address _addr) {
if (_addr == address(0)) revert ZERO_ADDRESS();
_;
}
modifier nonZeroValue(bytes32 _value) {
if (_value == 0) revert ZERO_VALUE();
_;
}
/// @custom:oz-upgrades-unsafe-allow constructor
constructor() {
_disableInitializers();
}
/// @notice Pauses the contract.
function pause() public virtual {
_pause();
// We call the authorize function here to avoid:
// Warning (5740): Unreachable code.
_authorizePause(msg.sender, true);
}
/// @notice Unpauses the contract.
function unpause() public virtual {
_unpause();
// We call the authorize function here to avoid:
// Warning (5740): Unreachable code.
_authorizePause(msg.sender, false);
}
function impl() public view returns (address) {
return _getImplementation();
}
/// @notice Returns true if the contract is paused, and false otherwise.
/// @return true if paused, false otherwise.
function paused() public view returns (bool) {
return __paused == _TRUE;
}
function inNonReentrant() public view returns (bool) {
return _loadReentryLock() == _TRUE;
}
/// @notice Initializes the contract.
/// @param _owner The owner of this contract. msg.sender will be used if this value is zero.
/// @param _addressManager The address of the {AddressManager} contract.
function __Essential_init(
address _owner,
address _addressManager
)
internal
nonZeroAddr(_addressManager)
{
__Essential_init(_owner);
__AddressResolver_init(_addressManager);
}
function __Essential_init(address _owner) internal virtual onlyInitializing {
__Context_init();
_transferOwnership(_owner == address(0) ? msg.sender : _owner);
__paused = _FALSE;
}
function _pause() internal whenNotPaused {
__paused = _TRUE;
emit Paused(msg.sender);
}
function _unpause() internal whenPaused {
__paused = _FALSE;
lastUnpausedAt = uint64(block.timestamp);
emit Unpaused(msg.sender);
}
function _authorizeUpgrade(address) internal virtual override onlyOwner { }
function _authorizePause(address, bool) internal virtual onlyOwner { }
// Stores the reentry lock
function _storeReentryLock(uint8 _reentry) internal virtual {
if (LibNetwork.isDencunSupported(block.chainid)) {
assembly {
tstore(_REENTRY_SLOT, _reentry)
}
} else {
__reentry = _reentry;
}
}
// Loads the reentry lock
function _loadReentryLock() internal view virtual returns (uint8 reentry_) {
if (LibNetwork.isDencunSupported(block.chainid)) {
assembly {
reentry_ := tload(_REENTRY_SLOT)
}
} else {
reentry_ = __reentry;
}
}
}
Compiler Settings
{"viaIR":false,"remappings":["@openzeppelin/contracts-upgradeable/=node_modules/@openzeppelin/contracts-upgradeable/","@openzeppelin/contracts/=node_modules/@openzeppelin/contracts/","solady/=node_modules/solady/","forge-std/=node_modules/forge-std/","ds-test/=node_modules/ds-test/src/","p256-verifier/=node_modules/p256-verifier/","forge-safe/=node_modules/forge-safe/"],"outputSelection":{"*":{"*":["*"],"":["*"]}},"optimizer":{"runs":200,"enabled":true},"metadata":{"useLiteralContent":false,"bytecodeHash":"ipfs","appendCBOR":true},"libraries":{},"evmVersion":"cancun"}
Contract ABI
[{"type":"error","name":"ETH_TRANSFER_FAILED","inputs":[]},{"type":"error","name":"FUNC_NOT_IMPLEMENTED","inputs":[]},{"type":"error","name":"INVALID_PAUSE_STATUS","inputs":[]},{"type":"error","name":"REENTRANT_CALL","inputs":[]},{"type":"error","name":"RESOLVER_DENIED","inputs":[]},{"type":"error","name":"RESOLVER_INVALID_MANAGER","inputs":[]},{"type":"error","name":"RESOLVER_UNEXPECTED_CHAINID","inputs":[]},{"type":"error","name":"RESOLVER_ZERO_ADDR","inputs":[{"type":"uint64","name":"chainId","internalType":"uint64"},{"type":"bytes32","name":"name","internalType":"bytes32"}]},{"type":"error","name":"VAULT_BTOKEN_BLACKLISTED","inputs":[]},{"type":"error","name":"VAULT_CTOKEN_MISMATCH","inputs":[]},{"type":"error","name":"VAULT_INVALID_AMOUNT","inputs":[]},{"type":"error","name":"VAULT_INVALID_NEW_BTOKEN","inputs":[]},{"type":"error","name":"VAULT_INVALID_TOKEN","inputs":[]},{"type":"error","name":"VAULT_INVALID_TO_ADDR","inputs":[]},{"type":"error","name":"VAULT_LAST_MIGRATION_TOO_CLOSE","inputs":[]},{"type":"error","name":"VAULT_PERMISSION_DENIED","inputs":[]},{"type":"error","name":"ZERO_ADDRESS","inputs":[]},{"type":"error","name":"ZERO_VALUE","inputs":[]},{"type":"event","name":"AdminChanged","inputs":[{"type":"address","name":"previousAdmin","internalType":"address","indexed":false},{"type":"address","name":"newAdmin","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"BeaconUpgraded","inputs":[{"type":"address","name":"beacon","internalType":"address","indexed":true}],"anonymous":false},{"type":"event","name":"BridgedTokenChanged","inputs":[{"type":"uint256","name":"srcChainId","internalType":"uint256","indexed":true},{"type":"address","name":"ctoken","internalType":"address","indexed":true},{"type":"address","name":"btokenOld","internalType":"address","indexed":false},{"type":"address","name":"btokenNew","internalType":"address","indexed":false},{"type":"string","name":"ctokenSymbol","internalType":"string","indexed":false},{"type":"string","name":"ctokenName","internalType":"string","indexed":false},{"type":"uint8","name":"ctokenDecimal","internalType":"uint8","indexed":false}],"anonymous":false},{"type":"event","name":"BridgedTokenDeployed","inputs":[{"type":"uint256","name":"srcChainId","internalType":"uint256","indexed":true},{"type":"address","name":"ctoken","internalType":"address","indexed":true},{"type":"address","name":"btoken","internalType":"address","indexed":true},{"type":"string","name":"ctokenSymbol","internalType":"string","indexed":false},{"type":"string","name":"ctokenName","internalType":"string","indexed":false},{"type":"uint8","name":"ctokenDecimal","internalType":"uint8","indexed":false}],"anonymous":false},{"type":"event","name":"Initialized","inputs":[{"type":"uint8","name":"version","internalType":"uint8","indexed":false}],"anonymous":false},{"type":"event","name":"OwnershipTransferStarted","inputs":[{"type":"address","name":"previousOwner","internalType":"address","indexed":true},{"type":"address","name":"newOwner","internalType":"address","indexed":true}],"anonymous":false},{"type":"event","name":"OwnershipTransferred","inputs":[{"type":"address","name":"previousOwner","internalType":"address","indexed":true},{"type":"address","name":"newOwner","internalType":"address","indexed":true}],"anonymous":false},{"type":"event","name":"Paused","inputs":[{"type":"address","name":"account","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"TokenReceived","inputs":[{"type":"bytes32","name":"msgHash","internalType":"bytes32","indexed":true},{"type":"address","name":"from","internalType":"address","indexed":true},{"type":"address","name":"to","internalType":"address","indexed":true},{"type":"uint64","name":"srcChainId","internalType":"uint64","indexed":false},{"type":"address","name":"ctoken","internalType":"address","indexed":false},{"type":"address","name":"token","internalType":"address","indexed":false},{"type":"uint256","name":"amount","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"TokenReleased","inputs":[{"type":"bytes32","name":"msgHash","internalType":"bytes32","indexed":true},{"type":"address","name":"from","internalType":"address","indexed":true},{"type":"address","name":"ctoken","internalType":"address","indexed":false},{"type":"address","name":"token","internalType":"address","indexed":false},{"type":"uint256","name":"amount","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"TokenSent","inputs":[{"type":"bytes32","name":"msgHash","internalType":"bytes32","indexed":true},{"type":"address","name":"from","internalType":"address","indexed":true},{"type":"address","name":"to","internalType":"address","indexed":true},{"type":"uint64","name":"destChainId","internalType":"uint64","indexed":false},{"type":"address","name":"ctoken","internalType":"address","indexed":false},{"type":"address","name":"token","internalType":"address","indexed":false},{"type":"uint256","name":"amount","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"Unpaused","inputs":[{"type":"address","name":"account","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"Upgraded","inputs":[{"type":"address","name":"implementation","internalType":"address","indexed":true}],"anonymous":false},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"MIN_MIGRATION_DELAY","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"acceptOwnership","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"addressManager","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint64","name":"chainId","internalType":"uint64"},{"type":"address","name":"addr","internalType":"address"},{"type":"uint8","name":"decimals","internalType":"uint8"},{"type":"string","name":"symbol","internalType":"string"},{"type":"string","name":"name","internalType":"string"}],"name":"bridgedToCanonical","inputs":[{"type":"address","name":"btoken","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"blacklisted","internalType":"bool"}],"name":"btokenBlacklist","inputs":[{"type":"address","name":"btoken","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"btoken","internalType":"address"}],"name":"canonicalToBridged","inputs":[{"type":"uint256","name":"chainId","internalType":"uint256"},{"type":"address","name":"ctoken","internalType":"address"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"address","name":"btokenOld_","internalType":"address"}],"name":"changeBridgedToken","inputs":[{"type":"tuple","name":"_ctoken","internalType":"struct ERC20Vault.CanonicalERC20","components":[{"type":"uint64","name":"chainId","internalType":"uint64"},{"type":"address","name":"addr","internalType":"address"},{"type":"uint8","name":"decimals","internalType":"uint8"},{"type":"string","name":"symbol","internalType":"string"},{"type":"string","name":"name","internalType":"string"}]},{"type":"address","name":"_btokenNew","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"impl","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"inNonReentrant","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"init","inputs":[{"type":"address","name":"_owner","internalType":"address"},{"type":"address","name":"_addressManager","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"timestamp","internalType":"uint256"}],"name":"lastMigrationStart","inputs":[{"type":"uint256","name":"chainId","internalType":"uint256"},{"type":"address","name":"ctoken","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint64","name":"","internalType":"uint64"}],"name":"lastUnpausedAt","inputs":[]},{"type":"function","stateMutability":"pure","outputs":[{"type":"bytes32","name":"","internalType":"bytes32"}],"name":"name","inputs":[]},{"type":"function","stateMutability":"payable","outputs":[],"name":"onMessageInvocation","inputs":[{"type":"bytes","name":"_data","internalType":"bytes"}]},{"type":"function","stateMutability":"payable","outputs":[],"name":"onMessageRecalled","inputs":[{"type":"tuple","name":"_message","internalType":"struct IBridge.Message","components":[{"type":"uint64","name":"id","internalType":"uint64"},{"type":"uint64","name":"fee","internalType":"uint64"},{"type":"uint32","name":"gasLimit","internalType":"uint32"},{"type":"address","name":"from","internalType":"address"},{"type":"uint64","name":"srcChainId","internalType":"uint64"},{"type":"address","name":"srcOwner","internalType":"address"},{"type":"uint64","name":"destChainId","internalType":"uint64"},{"type":"address","name":"destOwner","internalType":"address"},{"type":"address","name":"to","internalType":"address"},{"type":"uint256","name":"value","internalType":"uint256"},{"type":"bytes","name":"data","internalType":"bytes"}]},{"type":"bytes32","name":"_msgHash","internalType":"bytes32"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"owner","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"pause","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"paused","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"pendingOwner","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bytes32","name":"","internalType":"bytes32"}],"name":"proxiableUUID","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"renounceOwnership","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address payable"}],"name":"resolve","inputs":[{"type":"uint64","name":"_chainId","internalType":"uint64"},{"type":"bytes32","name":"_name","internalType":"bytes32"},{"type":"bool","name":"_allowZeroAddress","internalType":"bool"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address payable"}],"name":"resolve","inputs":[{"type":"bytes32","name":"_name","internalType":"bytes32"},{"type":"bool","name":"_allowZeroAddress","internalType":"bool"}]},{"type":"function","stateMutability":"payable","outputs":[{"type":"tuple","name":"message_","internalType":"struct IBridge.Message","components":[{"type":"uint64","name":"id","internalType":"uint64"},{"type":"uint64","name":"fee","internalType":"uint64"},{"type":"uint32","name":"gasLimit","internalType":"uint32"},{"type":"address","name":"from","internalType":"address"},{"type":"uint64","name":"srcChainId","internalType":"uint64"},{"type":"address","name":"srcOwner","internalType":"address"},{"type":"uint64","name":"destChainId","internalType":"uint64"},{"type":"address","name":"destOwner","internalType":"address"},{"type":"address","name":"to","internalType":"address"},{"type":"uint256","name":"value","internalType":"uint256"},{"type":"bytes","name":"data","internalType":"bytes"}]}],"name":"sendToken","inputs":[{"type":"tuple","name":"_op","internalType":"struct ERC20Vault.BridgeTransferOp","components":[{"type":"uint64","name":"destChainId","internalType":"uint64"},{"type":"address","name":"destOwner","internalType":"address"},{"type":"address","name":"to","internalType":"address"},{"type":"uint64","name":"fee","internalType":"uint64"},{"type":"address","name":"token","internalType":"address"},{"type":"uint32","name":"gasLimit","internalType":"uint32"},{"type":"uint256","name":"amount","internalType":"uint256"}]}]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"supportsInterface","inputs":[{"type":"bytes4","name":"_interfaceId","internalType":"bytes4"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"transferOwnership","inputs":[{"type":"address","name":"newOwner","internalType":"address"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"unpause","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"upgradeTo","inputs":[{"type":"address","name":"newImplementation","internalType":"address"}]},{"type":"function","stateMutability":"payable","outputs":[],"name":"upgradeToAndCall","inputs":[{"type":"address","name":"newImplementation","internalType":"address"},{"type":"bytes","name":"data","internalType":"bytes"}]}]
Deployed ByteCode
0x608060405260043610620001df575f3560e01c8063715018a61162000106578063a86f9d9e116200009e578063e07baba6116200006a578063e07baba61462000567578063e30c397814620005a7578063f09a401614620005c6578063f2fde38b14620005ea575f80fd5b8063a86f9d9e14620004d2578063b84d9ffe14620004f6578063caec3e4e146200051c578063d56ad7ac146200054f575f80fd5b80638456cb5911620000de5780638456cb59146200044e5780638abf607714620004655780638da5cb5b146200047c5780639aa8605c146200049b575f80fd5b8063715018a6146200040957806379ba509714620004205780637f07c9471462000437575f80fd5b80633ab76e9f116200017a5780634f1ef28611620001525780634f1ef286146200037557806352d1902d146200038c5780635c975abb14620003a357806367090ccf14620003c5575f80fd5b80633ab76e9f14620003195780633eb6b8cf146200033a5780633f4ba83a146200035e575f80fd5b806306fdde0311620001ba57806306fdde03146200027f5780630ecd8be914620002a15780633075db5614620002de5780633659cfe614620002f5575f80fd5b80630178733a14620001e357806301ffc9a714620001fc578063066fe7b41462000235575b5f80fd5b620001fa620001f436600462003578565b6200060e565b005b34801562000208575f80fd5b50620002206200021a366004620035c1565b620007b6565b60405190151581526020015b60405180910390f35b34801562000241575f80fd5b506200027062000253366004620035ff565b61013060209081525f928352604080842090915290825290205481565b6040519081526020016200022c565b3480156200028b575f80fd5b506a195c98cc8c17dd985d5b1d60aa1b62000270565b348015620002ad575f80fd5b50620002c5620002bf36600462003630565b62000808565b6040516001600160a01b0390911681526020016200022c565b348015620002ea575f80fd5b506200022062000ef8565b34801562000301575f80fd5b50620001fa620003133660046200367c565b62000f0e565b34801562000325575f80fd5b50609754620002c5906001600160a01b031681565b34801562000346575f80fd5b50620002c562000358366004620036bd565b62000fea565b3480156200036a575f80fd5b50620001fa62001002565b620001fa620003863660046200381a565b6200101a565b34801562000398575f80fd5b5062000270620010db565b348015620003af575f80fd5b506200022060c954610100900460ff1660021490565b348015620003d1575f80fd5b50620002c5620003e3366004620035ff565b61012e60209081525f92835260408084209091529082529020546001600160a01b031681565b34801562000415575f80fd5b50620001fa6200118f565b3480156200042c575f80fd5b50620001fa620011a4565b620001fa620004483660046200386c565b6200121f565b3480156200045a575f80fd5b50620001fa6200137f565b34801562000471575f80fd5b50620002c562001396565b34801562000488575f80fd5b506033546001600160a01b0316620002c5565b348015620004a7575f80fd5b50620004bf620004b93660046200367c565b620013a6565b6040516200022c9594939291906200392d565b348015620004de575f80fd5b50620002c5620004f03660046200398a565b6200150b565b6200050d62000507366004620039b0565b62001519565b6040516200022c9190620039c7565b34801562000528575f80fd5b50620002206200053a3660046200367c565b61012f6020525f908152604090205460ff1681565b3480156200055b575f80fd5b50620002706276a70081565b34801562000573575f80fd5b5060c9546200058e906201000090046001600160401b031681565b6040516001600160401b0390911681526020016200022c565b348015620005b3575f80fd5b506065546001600160a01b0316620002c5565b348015620005d2575f80fd5b50620001fa620005e436600462003ac8565b62001939565b348015620005f6575f80fd5b50620001fa620006083660046200367c565b62001a51565b6200062360c954610100900460ff1660021490565b15620006425760405163bae6e2a960e01b815260040160405180910390fd5b60026200064e62001ac5565b60ff1603620006705760405163dfc60d8560e01b815260040160405180910390fd5b6200067c600262001b07565b6200068662001b52565b505f6200069861014084018462003ae7565b620006a891600490829062003b33565b810190620006b7919062003b5c565b90505f8082806020019051810190620006d1919062003c10565b9350505091505f620006f9838760a0016020810190620006f291906200367c565b8462001c4f565b9050620007276101208701356200071760c0890160a08a016200367c565b6001600160a01b03169062001d01565b6200073960c0870160a088016200367c565b6001600160a01b0316857f3dea0f5955b148debf6212261e03bd80eaf8534bee43780452d16637dcc22dd5856020015184866040516200079a939291906001600160a01b039384168152919092166020820152604081019190915260600190565b60405180910390a350505050620007b2600162001b07565b5050565b5f6001600160e01b0319821662bc399d60e11b1480620007e657506001600160e01b03198216637f07c94760e01b145b806200080257506001600160e01b031982166301ffc9a760e01b145b92915050565b5f6200081362001d0e565b60026200081f62001ac5565b60ff1603620008415760405163dfc60d8560e01b815260040160405180910390fd5b6200084d600262001b07565b6001600160a01b03821615806200088457506001600160a01b038281165f90815261012d6020526040902054600160401b90041615155b15620008a35760405163dc63f98760e01b815260040160405180910390fd5b6001600160a01b0382165f90815261012f602052604090205460ff1615620008de576040516375c42fc160e01b815260040160405180910390fd5b5f61013081620008f2602087018762003d0f565b6001600160401b031681526020019081526020015f205f8560200160208101906200091e91906200367c565b6001600160a01b0316815260208101919091526040015f20549050620009486276a7008262003d41565b421015620009695760405163231d35fb60e11b815260040160405180910390fd5b61012e5f6200097c602087018762003d0f565b6001600160401b031681526020019081526020015f205f856020016020810190620009a891906200367c565b6001600160a01b03908116825260208201929092526040015f2054169150811562000d32576001600160a01b038281165f90815261012d60209081526040808320815160a08101835281546001600160401b0381168252600160401b810490961693810193909352600160e01b90940460ff16908201526001830180549293919260608401919062000a3a9062003d57565b80601f016020809104026020016040519081016040528092919081815260200182805462000a689062003d57565b801562000ab75780601f1062000a8d5761010080835404028352916020019162000ab7565b820191905f5260205f20905b81548152906001019060200180831162000a9957829003601f168201915b5050505050815260200160028201805462000ad29062003d57565b80601f016020809104026020016040519081016040528092919081815260200182805462000b009062003d57565b801562000b4f5780601f1062000b255761010080835404028352916020019162000b4f565b820191905f5260205f20905b81548152906001019060200180831162000b3157829003601f168201915b50505050508152505090508060405160200162000b6d919062003df7565b604051602081830303815290604052805190602001208560405160200162000b96919062003e84565b604051602081830303815290604052805190602001201462000bcb57604051632f9d1d7b60e11b815260040160405180910390fd5b6001600160a01b0383165f90815261012d6020526040812080546001600160e81b03191681559062000c01600183018262003518565b62000c10600283015f62003518565b50506001600160a01b0383165f81815261012f60205260409020805460ff1916600117905562000c489063b8f2e0c560e01b62001d6a565b801562000c6c575062000c6c6001600160a01b03851663b8f2e0c560e01b62001d6a565b1562000d305760405163b8f2e0c560e01b81526001600160a01b0385811660048301525f602483015284169063b8f2e0c5906044015f604051808303815f87803b15801562000cb9575f80fd5b505af115801562000ccc573d5f803e3d5ffd5b505060405163b8f2e0c560e01b81526001600160a01b038681166004830152600160248301528716925063b8f2e0c591506044015f604051808303815f87803b15801562000d18575f80fd5b505af115801562000d2b573d5f803e3d5ffd5b505050505b505b6001600160a01b0383165f90815261012d60205260409020849062000d58828262004046565b5083905061012e5f62000d6f602088018862003d0f565b6001600160401b031681526020019081526020015f205f86602001602081019062000d9b91906200367c565b6001600160a01b03166001600160a01b031681526020019081526020015f205f6101000a8154816001600160a01b0302191690836001600160a01b03160217905550426101305f865f01602081019062000df6919062003d0f565b6001600160401b031681526020019081526020015f205f86602001602081019062000e2291906200367c565b6001600160a01b03166001600160a01b031681526020019081526020015f208190555083602001602081019062000e5a91906200367c565b6001600160a01b031662000e72602086018662003d0f565b6001600160401b03167f031d68e1805917560c34a5f55a7dd91bef98f911190ed02cdbb53caedae6c39d848662000ead60608a018a62003ae7565b62000ebc60808c018c62003ae7565b62000ece60608e0160408f016200411b565b60405162000ee3979695949392919062004139565b60405180910390a35062000802600162001b07565b5f600262000f0562001ac5565b60ff1614905090565b6001600160a01b037f000000000000000000000000016700000000000000000000000000000000000216300362000f625760405162461bcd60e51b815260040162000f599062004194565b60405180910390fd5b7f00000000000000000000000001670000000000000000000000000000000000026001600160a01b031662000f9662001dfd565b6001600160a01b03161462000fbf5760405162461bcd60e51b815260040162000f5990620041e0565b62000fca8162001e19565b604080515f8082526020820190925262000fe79183919062001e23565b50565b5f62000ff884848462001f9a565b90505b9392505050565b6200100c62002092565b62001018335f62002124565b565b6001600160a01b037f0000000000000000000000000167000000000000000000000000000000000002163003620010655760405162461bcd60e51b815260040162000f599062004194565b7f00000000000000000000000001670000000000000000000000000000000000026001600160a01b03166200109962001dfd565b6001600160a01b031614620010c25760405162461bcd60e51b815260040162000f5990620041e0565b620010cd8262001e19565b620007b28282600162001e23565b5f306001600160a01b037f000000000000000000000000016700000000000000000000000000000000000216146200117c5760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c0000000000000000606482015260840162000f59565b505f8051602062004d1883398151915290565b6200119962001d0e565b620010185f6200212e565b60655433906001600160a01b03168114620012145760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b606482015260840162000f59565b62000fe7816200212e565b6200123460c954610100900460ff1660021490565b15620012535760405163bae6e2a960e01b815260040160405180910390fd5b60026200125f62001ac5565b60ff1603620012815760405163dfc60d8560e01b815260040160405180910390fd5b6200128d600262001b07565b5f8080806200129f8587018762004239565b93509350935093505f620012b262002149565b9050620012bf8362002271565b5f620012cd86858562001c4f565b9050620012e46001600160a01b0385163462001d01565b836001600160a01b0316856001600160a01b0316835f01517f75a051823424fc80e92556c41cb0ad977ae1dcb09c68a9c38acab86b11a69f8985604001518a6020015186896040516200136594939291906001600160401b039490941684526001600160a01b03928316602085015291166040830152606082015260800190565b60405180910390a4505050505050620007b2600162001b07565b62001389620022af565b6200101833600162002124565b5f620013a162001dfd565b905090565b61012d6020525f9081526040902080546001820180546001600160401b03831693600160401b84046001600160a01b031693600160e01b900460ff16929091620013f09062003d57565b80601f01602080910402602001604051908101604052809291908181526020018280546200141e9062003d57565b80156200146d5780601f1062001443576101008083540402835291602001916200146d565b820191905f5260205f20905b8154815290600101906020018083116200144f57829003601f168201915b505050505090806002018054620014849062003d57565b80601f0160208091040260200160405190810160405280929190818152602001828054620014b29062003d57565b8015620015015780601f10620014d75761010080835404028352916020019162001501565b820191905f5260205f20905b815481529060010190602001808311620014e357829003601f168201915b5050505050905085565b5f62000ffb46848462001f9a565b60408051610160810182525f8082526020820181905291810182905260608082018390526080820183905260a0820183905260c0820183905260e0820183905261010082018390526101208201929092526101408101919091526200158860c954610100900460ff1660021490565b15620015a75760405163bae6e2a960e01b815260040160405180910390fd5b6002620015b362001ac5565b60ff1603620015d55760405163dfc60d8560e01b815260040160405180910390fd5b620015e1600262001b07565b8160c001355f036200160657604051634299323b60e11b815260040160405180910390fd5b5f6200161960a08401608085016200367c565b6001600160a01b03160362001641576040516303f8a7d360e01b815260040160405180910390fd5b61012f5f6200165760a08501608086016200367c565b6001600160a01b0316815260208101919091526040015f205460ff161562001692576040516375c42fc160e01b815260040160405180910390fd5b5f805f620016a08562002323565b6040805161016081019091525f808252939650919450925060208101620016ce6080890160608a0162003d0f565b6001600160401b03168152602001620016ee60c0890160a08a016200434a565b63ffffffff1681525f60208083018290526040830191909152336060830152608090910190620017219089018962003d0f565b6001600160401b031681526020015f6001600160a01b03168860200160208101906200174e91906200367c565b6001600160a01b03160362001764573362001776565b620017766040890160208a016200367c565b6001600160a01b03168152602090810190620017b1906200179a908a018a62003d0f565b6a195c98cc8c17dd985d5b1d60aa1b5b5f62000fea565b6001600160a01b03168152602001620017d16080890160608a0162003d0f565b620017e6906001600160401b03163462004368565b815260200185905290505f620018066562726964676560d01b826200150b565b6001600160a01b0316631bdb003734846040518363ffffffff1660e01b8152600401620018349190620039c7565b5f6040518083038185885af115801562001850573d5f803e3d5ffd5b50505050506040513d5f823e601f3d908101601f191682016040526200187a91908101906200438b565b965090506200189060608801604089016200367c565b60a08701516001600160a01b039182169116827feb8a69f21b7a981e25f90d9f1e2ab7fa5bdbfddbc0ac160344145fc5caa6ddd2620018d360208c018c62003d0f565b6020890151620018ea60a08e0160808f016200367c565b604080516001600160401b0390941684526001600160a01b0392831660208501529116908201526060810188905260800160405180910390a4505050505062001934600162001b07565b919050565b5f54610100900460ff16158080156200195857505f54600160ff909116105b80620019735750303b1580156200197357505f5460ff166001145b620019d85760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840162000f59565b5f805460ff191660011790558015620019fa575f805461ff0019166101001790555b62001a068383620027f9565b801562001a4c575f805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b62001a5b62001d0e565b606580546001600160a01b0383166001600160a01b0319909116811790915562001a8d6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b5f62001ad14662002838565b1562001afd57507fa5054f728453d3dbe953bdc43e4d0cb97e662ea32d7958190f3dc2da31d9721b5c90565b5060c95460ff1690565b62001b124662002838565b1562001b3e57807fa5054f728453d3dbe953bdc43e4d0cb97e662ea32d7958190f3dc2da31d9721b5d50565b60c9805460ff831660ff1990911617905550565b604080516060810182525f80825260208201819052918101919091526562726964676560d01b62001b858160016200150b565b6001600160a01b0316336001600160a01b03161462001bb757604051630d85cccf60e11b815260040160405180910390fd5b336001600160a01b031663d0496d6a6040518163ffffffff1660e01b8152600401606060405180830381865afa15801562001bf4573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019062001c1a9190620044c0565b60208101519092506001600160a01b0316331462001c4b57604051632583296b60e01b815260040160405180910390fd5b5090565b5f46845f01516001600160401b03160362001c865750602083015162001c806001600160a01b03821684846200286a565b62001cf5565b62001c9184620028cf565b6040516340c10f1960e01b81526001600160a01b03858116600483015260248201859052919250908216906340c10f19906044015f604051808303815f87803b15801562001cdd575f80fd5b505af115801562001cf0573d5f803e3d5ffd5b505050505b62000ffb818362002914565b620007b282825a620029a8565b6033546001600160a01b03163314620010185760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640162000f59565b5f6001600160a01b0383163b62001d8357505f62000802565b6040516301ffc9a760e01b81526001600160e01b0319831660048201526001600160a01b038416906301ffc9a790602401602060405180830381865afa92505050801562001df0575060408051601f3d908101601f1916820190925262001ded918101906200452e565b60015b1562000802579392505050565b5f8051602062004d18833981519152546001600160a01b031690565b62000fe762001d0e565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff161562001e595762001a4c83620029ef565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa92505050801562001eb6575060408051601f3d908101601f1916820190925262001eb3918101906200454c565b60015b62001f1b5760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b606482015260840162000f59565b5f8051602062004d18833981519152811462001f8c5760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b606482015260840162000f59565b5062001a4c83838362002a8d565b6097545f906001600160a01b03168062001fc757604051638ed88b2560e01b815260040160405180910390fd5b604051630a3dc4f360e21b81526001600160401b0386166004820152602481018590526001600160a01b038216906328f713cc90604401602060405180830381865afa1580156200201a573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019062002040919062004564565b9150821580156200205857506001600160a01b038216155b156200208a57604051632b0d65db60e01b81526001600160401b03861660048201526024810185905260440162000f59565b509392505050565b620020a760c954610100900460ff1660021490565b620020c55760405163bae6e2a960e01b815260040160405180910390fd5b60c9805461010069ffffffffffffffffff001990911662010000426001600160401b031602171790556040513381527f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa906020015b60405180910390a1565b620007b262001d0e565b606580546001600160a01b031916905562000fe78162002abd565b604080516060810182525f80825260208201819052918101919091526562726964676560d01b6200217c8160016200150b565b6001600160a01b0316336001600160a01b031614620021ae57604051630d85cccf60e11b815260040160405180910390fd5b336001600160a01b031663d0496d6a6040518163ffffffff1660e01b8152600401606060405180830381865afa158015620021eb573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190620022119190620044c0565b91505f620022338360400151620017aa6a195c98cc8c17dd985d5b1d60aa1b90565b9050806001600160a01b031683602001516001600160a01b0316146200226c57604051632583296b60e01b815260040160405180910390fd5b505090565b6001600160a01b03811615806200229057506001600160a01b03811630145b1562000fe757604051635b50f3f960e01b815260040160405180910390fd5b620022c460c954610100900460ff1660021490565b15620022e35760405163bae6e2a960e01b815260040160405180910390fd5b60c9805461ff0019166102001790556040513381527f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258906020016200211a565b6040805160a0810182525f8082526020820181905291810191909152606081810181905260808201819052905f8061012d816200236760a08801608089016200367c565b6001600160a01b03908116825260208201929092526040015f208054909250600160401b90041615620025b7576040805160a08101825282546001600160401b0381168252600160401b81046001600160a01b03166020830152600160e01b900460ff169181019190915260018201805483916060840191620023ea9062003d57565b80601f0160208091040260200160405190810160405280929190818152602001828054620024189062003d57565b8015620024675780601f106200243d5761010080835404028352916020019162002467565b820191905f5260205f20905b8154815290600101906020018083116200244957829003601f168201915b50505050508152602001600282018054620024829062003d57565b80601f0160208091040260200160405190810160405280929190818152602001828054620024b09062003d57565b8015620024ff5780601f10620024d557610100808354040283529160200191620024ff565b820191905f5260205f20905b815481529060010190602001808311620024e157829003601f168201915b50505050508152505092506200253c33308760c001358860800160208101906200252a91906200367c565b6001600160a01b031692919062002b0e565b6200254e60a08601608087016200367c565b604051630852cd8d60e31b815260c087013560048201526001600160a01b0391909116906342966c68906024015f604051808303815f87803b15801562002593575f80fd5b505af1158015620025a6573d5f803e3d5ffd5b505050508460c00135915062002773565b6040518060a00160405280466001600160401b03168152602001866080016020810190620025e691906200367c565b6001600160a01b03168152602001620026106200260a60a0890160808a016200367c565b62002b48565b60ff168152602001620026346200262e60a0890160808a016200367c565b62002c0d565b8152602001620026556200264f60a0890160808a016200367c565b62002cbf565b905292505f6200266c60a08701608088016200367c565b6040516370a0823160e01b81523060048201529091505f906001600160a01b038316906370a0823190602401602060405180830381865afa158015620026b4573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190620026da91906200454c565b9050620026f76001600160a01b038316333060c08b013562002b0e565b6040516370a0823160e01b815230600482015281906001600160a01b038416906370a0823190602401602060405180830381865afa1580156200273c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906200276291906200454c565b6200276e919062004368565b935050505b30637f07c94784336200278d60608a0160408b016200367c565b86604051602001620027a3949392919062004582565b60408051601f1981840301815290829052620027c291602401620045b9565b604051602081830303815290604052915060e01b6020820180516001600160e01b0383818316178352505050509350509193909250565b806001600160a01b038116620028225760405163538ba4f960e01b815260040160405180910390fd5b6200282d8362002d07565b62001a4c8262002d6e565b5f60018214806200284a575061426882145b8062002858575062aa36a782145b80620008025750620008028262002de2565b6040516001600160a01b03831660248201526044810182905262001a4c90849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915262002dfa565b80516001600160401b03165f90815261012e60209081526040808320828501516001600160a01b03908116855292529091205416806200193457620008028262002ed4565b5f620029326c38bab7ba30afb6b0b730b3b2b960991b60016200150b565b90506001600160a01b0381161562001a4c576040516315c638fb60e31b81526001600160a01b0384811660048301526024820184905282169063ae31c7d8906044015f604051808303815f87803b1580156200298c575f80fd5b505af11580156200299f573d5f803e3d5ffd5b50505050505050565b815f03620029b557505050565b620029d183838360405180602001604052805f815250620030e6565b62001a4c57604051634c67134d60e11b815260040160405180910390fd5b6001600160a01b0381163b62002a5e5760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b606482015260840162000f59565b5f8051602062004d1883398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b62002a988362003124565b5f8251118062002aa55750805b1562001a4c5762002ab7838362003165565b50505050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6040516001600160a01b038085166024830152831660448201526064810182905262002ab79085906323b872dd60e01b9060840162002897565b60408051600481526024810182526020810180516001600160e01b031663313ce56760e01b17905290515f91829182916001600160a01b0386169162002b8f9190620045cd565b5f60405180830381855afa9150503d805f811462002bc9576040519150601f19603f3d011682016040523d82523d5f602084013e62002bce565b606091505b509150915081801562002be2575080516020145b62002bef57601262002c05565b8080602001905181019062002c059190620045ea565b949350505050565b60408051600481526024810182526020810180516001600160e01b03166395d89b4160e01b17905290516060915f9182916001600160a01b0386169162002c559190620045cd565b5f60405180830381855afa9150503d805f811462002c8f576040519150601f19603f3d011682016040523d82523d5f602084013e62002c94565b606091505b50915091508162002cb45760405180602001604052805f81525062002c05565b62002c05816200318d565b60408051600481526024810182526020810180516001600160e01b03166306fdde0360e01b17905290516060915f9182916001600160a01b0386169162002c559190620045cd565b5f54610100900460ff1662002d305760405162461bcd60e51b815260040162000f599062004608565b62002d3a620032e0565b62002d5c6001600160a01b0382161562002d5557816200212e565b336200212e565b5060c9805461ff001916610100179055565b5f54610100900460ff1662002d975760405162461bcd60e51b815260040162000f599062004608565b6001600160401b0346111562002dc05760405163a12e8fa960e01b815260040160405180910390fd5b609780546001600160a01b0319166001600160a01b0392909216919091179055565b5f617e2c821015801562000802575050617e90101590565b5f62002e50826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316620033099092919063ffffffff16565b905080515f148062002e7357508080602001905181019062002e7391906200452e565b62001a4c5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840162000f59565b5f8062002ee96033546001600160a01b031690565b60975460208501518551604080880151606089015160808a0151925162002f2197966001600160a01b03169594939060240162004653565b60408051601f198184030181529190526020810180516001600160e01b031663bb86ef9360e01b179052905062002f696c0627269646765645f657263323609c1b5f6200150b565b8160405162002f789062003554565b62002f85929190620046c2565b604051809103905ff08015801562002f9f573d5f803e3d5ffd5b506001600160a01b038082165f90815261012d602090815260409182902087518154928901519389015160ff16600160e01b0260ff60e01b1994909516600160401b026001600160e01b03199093166001600160401b03909116179190911791909116919091178155606085015191935084916001820190620030239082620046e7565b50608082015160028201906200303a9082620046e7565b505083516001600160401b039081165f90815261012e6020908152604080832082890180516001600160a01b039081168652919093529281902080546001600160a01b0319168885169081179091559151885160608a015160808b0151848c01519451959850929095169516937fb6b427556e8cb0ebf9175da4bc48c64c4f56e44cfaf8c3ab5ebf8e2ea130907993620030d89391929190620047b3565b60405180910390a450919050565b5f6001600160a01b0385166200310f57604051634c67134d60e11b815260040160405180910390fd5b5f80835160208501878988f195945050505050565b6200312f81620029ef565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b905f90a250565b606062000ffb838360405180606001604052806027815260200162004d386027913962003319565b60606040825110620031af5781806020019051810190620008029190620047ef565b8151602003620032cd575f5b602081108015620031ee5750828181518110620031dc57620031dc62004824565b01602001516001600160f81b03191615155b156200320757620031ff8162004838565b9050620031bb565b805f036200322457505060408051602081019091525f8152919050565b5f816001600160401b0381111562003240576200324062003701565b6040519080825280601f01601f1916602001820160405280156200326b576020820181803683370190505b5090505f5b828110156200208a578481815181106200328e576200328e62004824565b602001015160f81c60f81b828281518110620032ae57620032ae62004824565b60200101906001600160f81b03191690815f1a90535060010162003270565b505060408051602081019091525f815290565b5f54610100900460ff16620010185760405162461bcd60e51b815260040162000f599062004608565b606062000ff884845f8562003393565b60605f80856001600160a01b031685604051620033379190620045cd565b5f60405180830381855af49150503d805f811462003371576040519150601f19603f3d011682016040523d82523d5f602084013e62003376565b606091505b5091509150620033898683838762003472565b9695505050505050565b606082471015620033f65760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840162000f59565b5f80866001600160a01b03168587604051620034139190620045cd565b5f6040518083038185875af1925050503d805f81146200344f576040519150601f19603f3d011682016040523d82523d5f602084013e62003454565b606091505b5091509150620034678783838762003472565b979650505050505050565b60608315620034e55782515f03620034dd576001600160a01b0385163b620034dd5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640162000f59565b508162002c05565b62002c058383815115620034fc5781518083602001fd5b8060405162461bcd60e51b815260040162000f599190620045b9565b508054620035269062003d57565b5f825580601f1062003536575050565b601f0160209004905f5260205f209081019062000fe7919062003562565b6104c4806200485483390190565b5b8082111562001c4b575f815560010162003563565b5f80604083850312156200358a575f80fd5b82356001600160401b03811115620035a0575f80fd5b83016101608186031215620035b3575f80fd5b946020939093013593505050565b5f60208284031215620035d2575f80fd5b81356001600160e01b03198116811462000ffb575f80fd5b6001600160a01b038116811462000fe7575f80fd5b5f806040838503121562003611575f80fd5b8235915060208301356200362581620035ea565b809150509250929050565b5f806040838503121562003642575f80fd5b82356001600160401b0381111562003658575f80fd5b830160a081860312156200366a575f80fd5b915060208301356200362581620035ea565b5f602082840312156200368d575f80fd5b813562000ffb81620035ea565b6001600160401b038116811462000fe7575f80fd5b801515811462000fe7575f80fd5b5f805f60608486031215620036d0575f80fd5b8335620036dd816200369a565b9250602084013591506040840135620036f681620036af565b809150509250925092565b634e487b7160e01b5f52604160045260245ffd5b60405160a081016001600160401b03811182821017156200373a576200373a62003701565b60405290565b60405161016081016001600160401b03811182821017156200373a576200373a62003701565b604051601f8201601f191681016001600160401b038111828210171562003791576200379162003701565b604052919050565b5f6001600160401b03821115620037b457620037b462003701565b50601f01601f191660200190565b5f82601f830112620037d2575f80fd5b8135620037e9620037e38262003799565b62003766565b818152846020838601011115620037fe575f80fd5b816020850160208301375f918101602001919091529392505050565b5f80604083850312156200382c575f80fd5b82356200383981620035ea565b915060208301356001600160401b0381111562003854575f80fd5b6200386285828601620037c2565b9150509250929050565b5f80602083850312156200387e575f80fd5b82356001600160401b038082111562003895575f80fd5b818501915085601f830112620038a9575f80fd5b813581811115620038b8575f80fd5b866020828501011115620038ca575f80fd5b60209290920196919550909350505050565b5f5b83811015620038f8578181015183820152602001620038de565b50505f910152565b5f815180845262003919816020860160208601620038dc565b601f01601f19169290920160200192915050565b6001600160401b03861681526001600160a01b038516602082015260ff8416604082015260a0606082018190525f906200396a9083018562003900565b82810360808401526200397e818562003900565b98975050505050505050565b5f80604083850312156200399c575f80fd5b8235915060208301356200362581620036af565b5f60e08284031215620039c1575f80fd5b50919050565b60208152620039e26020820183516001600160401b03169052565b5f6020830151620039fe60408401826001600160401b03169052565b50604083015163ffffffff811660608401525060608301516001600160a01b03811660808401525060808301516001600160401b03811660a08401525060a08301516001600160a01b03811660c08401525060c08301516001600160401b03811660e08401525060e083015161010062003a82818501836001600160a01b03169052565b840151905061012062003a9f848201836001600160a01b03169052565b8401516101408481019190915284015161016080850152905062002c0561018084018262003900565b5f806040838503121562003ada575f80fd5b82356200366a81620035ea565b5f808335601e1984360301811262003afd575f80fd5b8301803591506001600160401b0382111562003b17575f80fd5b60200191503681900382131562003b2c575f80fd5b9250929050565b5f808585111562003b42575f80fd5b8386111562003b4f575f80fd5b5050820193919092039150565b5f6020828403121562003b6d575f80fd5b81356001600160401b0381111562003b83575f80fd5b62002c0584828501620037c2565b805162001934816200369a565b80516200193481620035ea565b60ff8116811462000fe7575f80fd5b8051620019348162003bab565b5f82601f83011262003bd7575f80fd5b815162003be8620037e38262003799565b81815284602083860101111562003bfd575f80fd5b62002c05826020830160208701620038dc565b5f805f806080858703121562003c24575f80fd5b84516001600160401b038082111562003c3b575f80fd5b9086019060a0828903121562003c4f575f80fd5b62003c5962003715565b825162003c66816200369a565b8152602083015162003c7881620035ea565b602082015262003c8b6040840162003bba565b604082015260608301518281111562003ca2575f80fd5b62003cb08a82860162003bc7565b60608301525060808301518281111562003cc8575f80fd5b62003cd68a82860162003bc7565b608083015250955062003cef9150506020860162003b9e565b925062003cff6040860162003b9e565b6060959095015193969295505050565b5f6020828403121562003d20575f80fd5b813562000ffb816200369a565b634e487b7160e01b5f52601160045260245ffd5b8082018082111562000802576200080262003d2d565b600181811c9082168062003d6c57607f821691505b602082108103620039c157634e487b7160e01b5f52602260045260245ffd5b6001600160401b03815116825260018060a01b03602082015116602083015260ff60408201511660408301525f606082015160a0606085015262003dd360a085018262003900565b90506080830151848203608086015262003dee828262003900565b95945050505050565b602081525f62000ffb602083018462003d8b565b8035620019348162003bab565b5f808335601e1984360301811262003e2e575f80fd5b83016020810192503590506001600160401b0381111562003e4d575f80fd5b80360382131562003b2c575f80fd5b81835281816020850137505f828201602090810191909152601f909101601f19169091010190565b602081525f823562003e96816200369a565b6001600160401b038116602084015250602083013562003eb681620035ea565b6001600160a01b031660408381019190915283013562003ed68162003bab565b60ff811660608401525062003eef606084018462003e18565b60a0608085015262003f0660c08501828462003e5c565b91505062003f18608085018562003e18565b848303601f190160a08601526200338983828462003e5c565b601f82111562001a4c57805f5260205f20601f840160051c8101602085101562003f585750805b601f840160051c820191505b8181101562003f79575f815560010162003f64565b5050505050565b6001600160401b0383111562003f9a5762003f9a62003701565b62003fb28362003fab835462003d57565b8362003f31565b5f601f84116001811462003fe6575f851562003fce5750838201355b5f19600387901b1c1916600186901b17835562003f79565b5f83815260208120601f198716915b8281101562004017578685013582556020948501946001909201910162003ff5565b508682101562004034575f1960f88860031b161c19848701351681555b505060018560011b0183555050505050565b813562004053816200369a565b6001600160401b03811690508154816001600160401b0319821617835560208401356200408081620035ea565b68010000000000000000600160e01b03604091821b166001600160e01b0319831684178117855590850135620040b68162003bab565b60ff60e01b8160e01b1660ff60e01b19851662ffffff60e81b851617831717855550505050620040ea606083018362003ae7565b620040fa81836001860162003f80565b50506200410b608083018362003ae7565b62002ab781836002860162003f80565b5f602082840312156200412c575f80fd5b813562000ffb8162003bab565b6001600160a01b0388811682528716602082015260a0604082018190525f9062004167908301878962003e5c565b82810360608401526200417c81868862003e5c565b91505060ff8316608083015298975050505050505050565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b80356200193481620035ea565b5f805f80608085870312156200424d575f80fd5b84356001600160401b038082111562004264575f80fd5b9086019060a0828903121562004278575f80fd5b6200428262003715565b82356200428f816200369a565b81526020830135620042a181620035ea565b6020820152620042b46040840162003e0b565b6040820152606083013582811115620042cb575f80fd5b620042d98a828601620037c2565b606083015250608083013582811115620042f1575f80fd5b620042ff8a828601620037c2565b608083015250955062004318915050602086016200422c565b925062004328604086016200422c565b9396929550929360600135925050565b63ffffffff8116811462000fe7575f80fd5b5f602082840312156200435b575f80fd5b813562000ffb8162004338565b8181038181111562000802576200080262003d2d565b8051620019348162004338565b5f80604083850312156200439d575f80fd5b8251915060208301516001600160401b0380821115620043bb575f80fd5b908401906101608287031215620043d0575f80fd5b620043da62003740565b620043e58362003b91565b8152620043f56020840162003b91565b602082015262004408604084016200437e565b60408201526200441b6060840162003b9e565b60608201526200442e6080840162003b91565b60808201526200444160a0840162003b9e565b60a08201526200445460c0840162003b91565b60c08201526200446760e0840162003b9e565b60e08201526101006200447c81850162003b9e565b90820152610120838101519082015261014080840151838111156200449f575f80fd5b620044ad8982870162003bc7565b8284015250508093505050509250929050565b5f60608284031215620044d1575f80fd5b604051606081018181106001600160401b0382111715620044f657620044f662003701565b6040528251815260208301516200450d81620035ea565b6020820152604083015162004522816200369a565b60408201529392505050565b5f602082840312156200453f575f80fd5b815162000ffb81620036af565b5f602082840312156200455d575f80fd5b5051919050565b5f6020828403121562004575575f80fd5b815162000ffb81620035ea565b608081525f62004596608083018762003d8b565b6001600160a01b0395861660208401529390941660408201526060015292915050565b602081525f62000ffb602083018462003900565b5f8251620045e0818460208701620038dc565b9190910192915050565b5f60208284031215620045fb575f80fd5b815162000ffb8162003bab565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b0388811682528781166020830152861660408201526001600160401b038516606082015260ff8416608082015260e060a082018190525f90620046a09083018562003900565b82810360c0840152620046b4818562003900565b9a9950505050505050505050565b6001600160a01b03831681526040602082018190525f9062000ff89083018462003900565b81516001600160401b0381111562004703576200470362003701565b6200471b8162004714845462003d57565b8462003f31565b602080601f83116001811462004751575f8415620047395750858301515b5f19600386901b1c1916600185901b178555620047ab565b5f85815260208120601f198616915b82811015620047815788860151825594840194600190910190840162004760565b50858210156200479f57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b606081525f620047c7606083018662003900565b8281036020840152620047db818662003900565b91505060ff83166040830152949350505050565b5f6020828403121562004800575f80fd5b81516001600160401b0381111562004816575f80fd5b62002c058482850162003bc7565b634e487b7160e01b5f52603260045260245ffd5b5f600182016200484c576200484c62003d2d565b506001019056fe60806040526040516104c43803806104c4833981016040819052610022916102d2565b61002d82825f610034565b50506103e7565b61003d8361005f565b5f825111806100495750805b1561005a57610058838361009e565b505b505050565b610068816100ca565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b905f90a250565b60606100c3838360405180606001604052806027815260200161049d6027913961017d565b9392505050565b6001600160a01b0381163b61013c5760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084015b60405180910390fd5b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80546001600160a01b0319166001600160a01b0392909216919091179055565b60605f80856001600160a01b031685604051610199919061039a565b5f60405180830381855af49150503d805f81146101d1576040519150601f19603f3d011682016040523d82523d5f602084013e6101d6565b606091505b5090925090506101e8868383876101f2565b9695505050505050565b606083156102605782515f03610259576001600160a01b0385163b6102595760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610133565b508161026a565b61026a8383610272565b949350505050565b8151156102825781518083602001fd5b8060405162461bcd60e51b815260040161013391906103b5565b634e487b7160e01b5f52604160045260245ffd5b5f5b838110156102ca5781810151838201526020016102b2565b50505f910152565b5f80604083850312156102e3575f80fd5b82516001600160a01b03811681146102f9575f80fd5b60208401519092506001600160401b0380821115610315575f80fd5b818501915085601f830112610328575f80fd5b81518181111561033a5761033a61029c565b604051601f8201601f19908116603f011681019083821181831017156103625761036261029c565b8160405282815288602084870101111561037a575f80fd5b61038b8360208301602088016102b0565b80955050505050509250929050565b5f82516103ab8184602087016102b0565b9190910192915050565b602081525f82518060208401526103d38160408501602087016102b0565b601f01601f19169190910160400192915050565b60aa806103f35f395ff3fe608060405236601057600e6013565b005b600e5b601f601b6021565b6057565b565b5f60527f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc546001600160a01b031690565b905090565b365f80375f80365f845af43d5f803e8080156070573d5ff35b3d5ffdfea26469706673582212202ab33c19ef73bba88d6c10c6990731f592afdeba0c87384fbaf36911918f5f4964736f6c63430008180033416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220ea36dcba768a52059ed0ed48fee13b0a8043b482e8915ed094ab8c2cf570450964736f6c63430008180033