Source Code
Overview
XDC Balance
XDC Value
$0.00Latest 1 internal transaction
Advanced mode:
| Parent Transaction Hash | Block | From | To | |||
|---|---|---|---|---|---|---|
| 92624021 | 85 days ago | Contract Creation | 0 XDC |
Cross-Chain Transactions
Loading...
Loading
Contract Name:
MessageTransmitterV2
Compiler Version
v0.7.6+commit.7338295f
Optimization Enabled:
Yes with 100000 runs
Other Settings:
istanbul EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {IMessageTransmitterV2} from "../interfaces/v2/IMessageTransmitterV2.sol";
import {BaseMessageTransmitter} from "./BaseMessageTransmitter.sol";
import {MessageV2} from "../messages/v2/MessageV2.sol";
import {AddressUtils} from "../messages/v2/AddressUtils.sol";
import {TypedMemView} from "@memview-sol/contracts/TypedMemView.sol";
import {IMessageHandlerV2} from "../interfaces/v2/IMessageHandlerV2.sol";
import {FINALITY_THRESHOLD_FINALIZED} from "./FinalityThresholds.sol";
/**
* @title MessageTransmitterV2
* @notice Contract responsible for sending and receiving messages across chains.
*/
contract MessageTransmitterV2 is IMessageTransmitterV2, BaseMessageTransmitter {
// ============ Events ============
/**
* @notice Emitted when a new message is dispatched
* @param message Raw bytes of message
*/
event MessageSent(bytes message);
/**
* @notice Emitted when a new message is received
* @param caller Caller (msg.sender) on destination domain
* @param sourceDomain The source domain this message originated from
* @param nonce The nonce unique to this message
* @param sender The sender of this message
* @param finalityThresholdExecuted The finality at which message was attested to
* @param messageBody message body bytes
*/
event MessageReceived(
address indexed caller,
uint32 sourceDomain,
bytes32 indexed nonce,
bytes32 sender,
uint32 indexed finalityThresholdExecuted,
bytes messageBody
);
// ============ Libraries ============
using AddressUtils for address;
using AddressUtils for address payable;
using AddressUtils for bytes32;
using MessageV2 for bytes29;
using TypedMemView for bytes;
using TypedMemView for bytes29;
// ============ Constructor ============
/**
* @param _localDomain Domain of chain on which the contract is deployed
* @param _version Message Format version
*/
constructor(
uint32 _localDomain,
uint32 _version
) BaseMessageTransmitter(_localDomain, _version) {
_disableInitializers();
}
// ============ Initializers ============
/**
* @notice Initializes the contract
* @dev Owner, pauser, rescuer, attesterManager, and attesters must be non-zero.
* @dev Signature threshold must be non-zero, but not exceed the number of enabled attesters
* @param owner_ Owner address
* @param pauser_ Pauser address
* @param rescuer_ Rescuer address
* @param attesterManager_ AttesterManager address
* @param attesters_ Set of attesters to enable
* @param signatureThreshold_ Signature threshold
* @param maxMessageBodySize_ Maximum message body size
*/
function initialize(
address owner_,
address pauser_,
address rescuer_,
address attesterManager_,
address[] calldata attesters_,
uint256 signatureThreshold_,
uint256 maxMessageBodySize_
) external initializer {
require(owner_ != address(0), "Owner is the zero address");
require(
attesterManager_ != address(0),
"AttesterManager is the zero address"
);
require(
signatureThreshold_ <= attesters_.length,
"Signature threshold exceeds attesters"
);
require(maxMessageBodySize_ > 0, "MaxMessageBodySize is zero");
// Roles
_transferOwnership(owner_);
_updateRescuer(rescuer_);
_updatePauser(pauser_);
_setAttesterManager(attesterManager_);
// Max message body size
_setMaxMessageBodySize(maxMessageBodySize_);
// Attester configuration
uint256 _attestersLength = attesters_.length;
for (uint256 i; i < _attestersLength; ++i) {
_enableAttester(attesters_[i]);
}
// Signature threshold
_setSignatureThreshold(signatureThreshold_);
// Claim 0-nonce
usedNonces[bytes32(0)] = NONCE_USED;
}
// ============ External Functions ============
/**
* @notice Send the message to the destination domain and recipient
* @dev Formats the message, and emits a `MessageSent` event with message information.
* @param destinationDomain Domain of destination chain
* @param recipient Address of message recipient on destination chain as bytes32
* @param destinationCaller Caller on the destination domain, as bytes32
* @param minFinalityThreshold The minimum finality at which the message should be attested to
* @param messageBody Contents of the message (bytes)
*/
function sendMessage(
uint32 destinationDomain,
bytes32 recipient,
bytes32 destinationCaller,
uint32 minFinalityThreshold,
bytes calldata messageBody
) external override whenNotPaused {
require(destinationDomain != localDomain, "Domain is local domain");
// Validate message body length
require(
messageBody.length <= maxMessageBodySize,
"Message body exceeds max size"
);
require(recipient != bytes32(0), "Recipient must be nonzero");
bytes32 _messageSender = msg.sender.toBytes32();
// serialize message
bytes memory _message = MessageV2._formatMessageForRelay(
version,
localDomain,
destinationDomain,
_messageSender,
recipient,
destinationCaller,
minFinalityThreshold,
messageBody
);
// Emit MessageSent event
emit MessageSent(_message);
}
/**
* @notice Receive a message. Messages can only be broadcast once for a given nonce.
* The message body of a valid message is passed to the specified recipient for further processing.
*
* @dev Attestation format:
* A valid attestation is the concatenated 65-byte signature(s) of exactly
* `thresholdSignature` signatures, in increasing order of attester address.
* ***If the attester addresses recovered from signatures are not in
* increasing order, signature verification will fail.***
* If incorrect number of signatures or duplicate signatures are supplied,
* signature verification will fail.
*
* Message Format:
*
* Field Bytes Type Index
* version 4 uint32 0
* sourceDomain 4 uint32 4
* destinationDomain 4 uint32 8
* nonce 32 bytes32 12
* sender 32 bytes32 44
* recipient 32 bytes32 76
* destinationCaller 32 bytes32 108
* minFinalityThreshold 4 uint32 140
* finalityThresholdExecuted 4 uint32 144
* messageBody dynamic bytes 148
* @param message Message bytes
* @param attestation Concatenated 65-byte signature(s) of `message`, in increasing order
* of the attester address recovered from signatures.
* @return success True, if successful; false, if not
*/
function receiveMessage(
bytes calldata message,
bytes calldata attestation
) external override whenNotPaused returns (bool success) {
// Validate message
(
bytes32 _nonce,
uint32 _sourceDomain,
bytes32 _sender,
address _recipient,
uint32 _finalityThresholdExecuted,
bytes memory _messageBody
) = _validateReceivedMessage(message, attestation);
// Mark nonce as used
usedNonces[_nonce] = NONCE_USED;
// Handle receive message
if (_finalityThresholdExecuted < FINALITY_THRESHOLD_FINALIZED) {
require(
IMessageHandlerV2(_recipient).handleReceiveUnfinalizedMessage(
_sourceDomain,
_sender,
_finalityThresholdExecuted,
_messageBody
),
"handleReceiveUnfinalizedMessage() failed"
);
} else {
require(
IMessageHandlerV2(_recipient).handleReceiveFinalizedMessage(
_sourceDomain,
_sender,
_finalityThresholdExecuted,
_messageBody
),
"handleReceiveFinalizedMessage() failed"
);
}
// Emit MessageReceived event
emit MessageReceived(
msg.sender,
_sourceDomain,
_nonce,
_sender,
_finalityThresholdExecuted,
_messageBody
);
return true;
}
/**
* @notice Validates a received message, including the attestation signatures as well
* as the message contents.
* @param _message Message bytes
* @param _attestation Concatenated 65-byte signature(s) of `message`
* @return _nonce Message nonce, as bytes32
* @return _sourceDomain Domain where message originated from
* @return _sender Sender of the message
* @return _recipient Recipient of the message
* @return _finalityThresholdExecuted The level of finality at which the message was attested to
* @return _messageBody The message body bytes
*/
function _validateReceivedMessage(
bytes calldata _message,
bytes calldata _attestation
)
internal
view
returns (
bytes32 _nonce,
uint32 _sourceDomain,
bytes32 _sender,
address _recipient,
uint32 _finalityThresholdExecuted,
bytes memory _messageBody
)
{
// Validate each signature in the attestation
_verifyAttestationSignatures(_message, _attestation);
bytes29 _msg = _message.ref(0);
// Validate message format
_msg._validateMessageFormat();
// Validate domain
require(
_msg._getDestinationDomain() == localDomain,
"Invalid destination domain"
);
// Validate destination caller
if (_msg._getDestinationCaller() != bytes32(0)) {
require(
_msg._getDestinationCaller() == msg.sender.toBytes32(),
"Invalid caller for message"
);
}
// Validate version
require(_msg._getVersion() == version, "Invalid message version");
// Validate nonce is available
_nonce = _msg._getNonce();
require(usedNonces[_nonce] == 0, "Nonce already used");
// Unpack remaining values
_sourceDomain = _msg._getSourceDomain();
_sender = _msg._getSender();
_recipient = _msg._getRecipient().toAddress();
_finalityThresholdExecuted = _msg._getFinalityThresholdExecuted();
_messageBody = _msg._getMessageBody().clone();
}
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {IReceiverV2} from "./IReceiverV2.sol";
import {IRelayerV2} from "./IRelayerV2.sol";
/**
* @title IMessageTransmitterV2
* @notice Interface for V2 message transmitters, which both relay and receive messages.
*/
interface IMessageTransmitterV2 is IRelayerV2, IReceiverV2 {
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {AttestableV2} from "../roles/v2/AttestableV2.sol";
import {Pausable} from "../roles/Pausable.sol";
import {Rescuable} from "../roles/Rescuable.sol";
import {Initializable} from "../proxy/Initializable.sol";
/**
* @title BaseMessageTransmitter
* @notice A base type containing administrative and configuration functionality for message transmitters.
*/
contract BaseMessageTransmitter is
Initializable,
Pausable,
Rescuable,
AttestableV2
{
// ============ Events ============
/**
* @notice Emitted when max message body size is updated
* @param newMaxMessageBodySize new maximum message body size, in bytes
*/
event MaxMessageBodySizeUpdated(uint256 newMaxMessageBodySize);
// ============ Constants ============
// A constant value indicating that a nonce has been used
uint256 public constant NONCE_USED = 1;
// ============ State Variables ============
// Domain of chain on which the contract is deployed
uint32 public immutable localDomain;
// Message Format version
uint32 public immutable version;
// Maximum size of message body, in bytes.
// This value is set by owner.
uint256 public maxMessageBodySize;
// Maps a bytes32 nonce -> uint256 (0 if unused, 1 if used)
mapping(bytes32 => uint256) public usedNonces;
// ============ Constructor ============
/**
* @param _localDomain Domain of chain on which the contract is deployed
* @param _version Message Format version
*/
constructor(uint32 _localDomain, uint32 _version) AttestableV2() {
localDomain = _localDomain;
version = _version;
}
// ============ External Functions ============
/**
* @notice Sets the max message body size
* @dev This value should not be reduced without good reason,
* to avoid impacting users who rely on large messages.
* @param newMaxMessageBodySize new max message body size, in bytes
*/
function setMaxMessageBodySize(
uint256 newMaxMessageBodySize
) external onlyOwner {
_setMaxMessageBodySize(newMaxMessageBodySize);
}
/**
* @notice Returns the current initialized version
*/
function initializedVersion() external view returns (uint64) {
return _getInitializedVersion();
}
// ============ Internal Utils ============
/**
* @notice Sets the max message body size
* @param _newMaxMessageBodySize new max message body size, in bytes
*/
function _setMaxMessageBodySize(uint256 _newMaxMessageBodySize) internal {
maxMessageBodySize = _newMaxMessageBodySize;
emit MaxMessageBodySizeUpdated(maxMessageBodySize);
}
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {TypedMemView} from "@memview-sol/contracts/TypedMemView.sol";
/**
* @title MessageV2 Library
* @notice Library for formatted v2 messages used by Relayer and Receiver.
*
* @dev The message body is dynamically-sized to support custom message body
* formats. Other fields must be fixed-size to avoid hash collisions.
* Each other input value has an explicit type to guarantee fixed-size.
* Padding: uintNN fields are left-padded, and bytesNN fields are right-padded.
*
* Field Bytes Type Index
* version 4 uint32 0
* sourceDomain 4 uint32 4
* destinationDomain 4 uint32 8
* nonce 32 bytes32 12
* sender 32 bytes32 44
* recipient 32 bytes32 76
* destinationCaller 32 bytes32 108
* minFinalityThreshold 4 uint32 140
* finalityThresholdExecuted 4 uint32 144
* messageBody dynamic bytes 148
* @dev Differences from v1:
* - Nonce is now bytes32 (vs. uint64)
* - minFinalityThreshold added
* - finalityThresholdExecuted added
**/
library MessageV2 {
using TypedMemView for bytes;
using TypedMemView for bytes29;
// Indices of each field in message
uint8 private constant VERSION_INDEX = 0;
uint8 private constant SOURCE_DOMAIN_INDEX = 4;
uint8 private constant DESTINATION_DOMAIN_INDEX = 8;
uint8 private constant NONCE_INDEX = 12;
uint8 private constant SENDER_INDEX = 44;
uint8 private constant RECIPIENT_INDEX = 76;
uint8 private constant DESTINATION_CALLER_INDEX = 108;
uint8 private constant MIN_FINALITY_THRESHOLD_INDEX = 140;
uint8 private constant FINALITY_THRESHOLD_EXECUTED_INDEX = 144;
uint8 private constant MESSAGE_BODY_INDEX = 148;
bytes32 private constant EMPTY_NONCE = bytes32(0);
uint32 private constant EMPTY_FINALITY_THRESHOLD_EXECUTED = 0;
/**
* @notice Returns formatted (packed) message with provided fields
* @param _version the version of the message format
* @param _sourceDomain Domain of home chain
* @param _destinationDomain Domain of destination chain
* @param _sender Address of sender on source chain as bytes32
* @param _recipient Address of recipient on destination chain as bytes32
* @param _destinationCaller Address of caller on destination chain as bytes32
* @param _minFinalityThreshold the minimum finality at which the message should be attested to
* @param _messageBody Raw bytes of message body
* @return Formatted message
**/
function _formatMessageForRelay(
uint32 _version,
uint32 _sourceDomain,
uint32 _destinationDomain,
bytes32 _sender,
bytes32 _recipient,
bytes32 _destinationCaller,
uint32 _minFinalityThreshold,
bytes calldata _messageBody
) internal pure returns (bytes memory) {
return
abi.encodePacked(
_version,
_sourceDomain,
_destinationDomain,
EMPTY_NONCE,
_sender,
_recipient,
_destinationCaller,
_minFinalityThreshold,
EMPTY_FINALITY_THRESHOLD_EXECUTED,
_messageBody
);
}
// @notice Returns _message's version field
function _getVersion(bytes29 _message) internal pure returns (uint32) {
return uint32(_message.indexUint(VERSION_INDEX, 4));
}
// @notice Returns _message's sourceDomain field
function _getSourceDomain(bytes29 _message) internal pure returns (uint32) {
return uint32(_message.indexUint(SOURCE_DOMAIN_INDEX, 4));
}
// @notice Returns _message's destinationDomain field
function _getDestinationDomain(
bytes29 _message
) internal pure returns (uint32) {
return uint32(_message.indexUint(DESTINATION_DOMAIN_INDEX, 4));
}
// @notice Returns _message's nonce field
function _getNonce(bytes29 _message) internal pure returns (bytes32) {
return _message.index(NONCE_INDEX, 32);
}
// @notice Returns _message's sender field
function _getSender(bytes29 _message) internal pure returns (bytes32) {
return _message.index(SENDER_INDEX, 32);
}
// @notice Returns _message's recipient field
function _getRecipient(bytes29 _message) internal pure returns (bytes32) {
return _message.index(RECIPIENT_INDEX, 32);
}
// @notice Returns _message's destinationCaller field
function _getDestinationCaller(
bytes29 _message
) internal pure returns (bytes32) {
return _message.index(DESTINATION_CALLER_INDEX, 32);
}
// @notice Returns _message's minFinalityThreshold field
function _getMinFinalityThreshold(
bytes29 _message
) internal pure returns (uint32) {
return uint32(_message.indexUint(MIN_FINALITY_THRESHOLD_INDEX, 4));
}
// @notice Returns _message's finalityThresholdExecuted field
function _getFinalityThresholdExecuted(
bytes29 _message
) internal pure returns (uint32) {
return uint32(_message.indexUint(FINALITY_THRESHOLD_EXECUTED_INDEX, 4));
}
// @notice Returns _message's messageBody field
function _getMessageBody(bytes29 _message) internal pure returns (bytes29) {
return
_message.slice(
MESSAGE_BODY_INDEX,
_message.len() - MESSAGE_BODY_INDEX,
0
);
}
/**
* @notice Reverts if message is malformed or too short
* @param _message The message as bytes29
*/
function _validateMessageFormat(bytes29 _message) internal pure {
require(_message.isValid(), "Malformed message");
require(
_message.len() >= MESSAGE_BODY_INDEX,
"Invalid message: too short"
);
}
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
/**
* @title AddressUtils Library
* @notice Helper functions for converting addresses to and from bytes
**/
library AddressUtils {
/**
* @notice Converts an address to bytes32 by left-padding with zeros (alignment preserving cast.)
* @param addr The address to convert to bytes32
*/
function toBytes32(address addr) internal pure returns (bytes32) {
return bytes32(uint256(uint160(addr)));
}
/**
* @notice Converts bytes32 to address (alignment preserving cast.)
* @dev Warning: it is possible to have different input values _buf map to the same address.
* For use cases where this is not acceptable, validate that the first 12 bytes of _buf are zero-padding.
* @param _buf the bytes32 to convert to address
*/
function toAddress(bytes32 _buf) internal pure returns (address) {
return address(uint160(uint256(_buf)));
}
}// SPDX-License-Identifier: MIT OR Apache-2.0
pragma solidity >=0.5.10 <0.8.0;
import {SafeMath} from "./SafeMath.sol";
library TypedMemView {
using SafeMath for uint256;
// Why does this exist?
// the solidity `bytes memory` type has a few weaknesses.
// 1. You can't index ranges effectively
// 2. You can't slice without copying
// 3. The underlying data may represent any type
// 4. Solidity never deallocates memory, and memory costs grow
// superlinearly
// By using a memory view instead of a `bytes memory` we get the following
// advantages:
// 1. Slices are done on the stack, by manipulating the pointer
// 2. We can index arbitrary ranges and quickly convert them to stack types
// 3. We can insert type info into the pointer, and typecheck at runtime
// This makes `TypedMemView` a useful tool for efficient zero-copy
// algorithms.
// Why bytes29?
// We want to avoid confusion between views, digests, and other common
// types so we chose a large and uncommonly used odd number of bytes
//
// Note that while bytes are left-aligned in a word, integers and addresses
// are right-aligned. This means when working in assembly we have to
// account for the 3 unused bytes on the righthand side
//
// First 5 bytes are a type flag.
// - ff_ffff_fffe is reserved for unknown type.
// - ff_ffff_ffff is reserved for invalid types/errors.
// next 12 are memory address
// next 12 are len
// bottom 3 bytes are empty
// Assumptions:
// - non-modification of memory.
// - No Solidity updates
// - - wrt free mem point
// - - wrt bytes representation in memory
// - - wrt memory addressing in general
// Usage:
// - create type constants
// - use `assertType` for runtime type assertions
// - - unfortunately we can't do this at compile time yet :(
// - recommended: implement modifiers that perform type checking
// - - e.g.
// - - `uint40 constant MY_TYPE = 3;`
// - - ` modifer onlyMyType(bytes29 myView) { myView.assertType(MY_TYPE); }`
// - instantiate a typed view from a bytearray using `ref`
// - use `index` to inspect the contents of the view
// - use `slice` to create smaller views into the same memory
// - - `slice` can increase the offset
// - - `slice can decrease the length`
// - - must specify the output type of `slice`
// - - `slice` will return a null view if you try to overrun
// - - make sure to explicitly check for this with `notNull` or `assertType`
// - use `equal` for typed comparisons.
// The null view
bytes29 public constant NULL = hex"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff";
// Mask a low uint96
uint256 constant LOW_12_MASK = 0xffffffffffffffffffffffff;
// Shift constants
uint8 constant SHIFT_TO_LEN = 24;
uint8 constant SHIFT_TO_LOC = 96 + 24;
uint8 constant SHIFT_TO_TYPE = 96 + 96 + 24;
// For nibble encoding
bytes private constant NIBBLE_LOOKUP = "0123456789abcdef";
/**
* @notice Returns the encoded hex character that represents the lower 4 bits of the argument.
* @param _byte The byte
* @return _char The encoded hex character
*/
function nibbleHex(uint8 _byte) internal pure returns (uint8 _char) {
uint8 _nibble = _byte & 0x0f; // keep bottom 4, 0 top 4
_char = uint8(NIBBLE_LOOKUP[_nibble]);
}
/**
* @notice Returns a uint16 containing the hex-encoded byte.
* @param _b The byte
* @return encoded - The hex-encoded byte
*/
function byteHex(uint8 _b) internal pure returns (uint16 encoded) {
encoded |= nibbleHex(_b >> 4); // top 4 bits
encoded <<= 8;
encoded |= nibbleHex(_b); // lower 4 bits
}
/**
* @notice Encodes the uint256 to hex. `first` contains the encoded top 16 bytes.
* `second` contains the encoded lower 16 bytes.
*
* @param _b The 32 bytes as uint256
* @return first - The top 16 bytes
* @return second - The bottom 16 bytes
*/
function encodeHex(uint256 _b) internal pure returns (uint256 first, uint256 second) {
for (uint8 i = 31; i > 15; i -= 1) {
uint8 _byte = uint8(_b >> (i * 8));
first |= byteHex(_byte);
if (i != 16) {
first <<= 16;
}
}
// abusing underflow here =_=
for (uint8 i = 15; i < 255 ; i -= 1) {
uint8 _byte = uint8(_b >> (i * 8));
second |= byteHex(_byte);
if (i != 0) {
second <<= 16;
}
}
}
/**
* @notice Changes the endianness of a uint256.
* @dev https://graphics.stanford.edu/~seander/bithacks.html#ReverseParallel
* @param _b The unsigned integer to reverse
* @return v - The reversed value
*/
function reverseUint256(uint256 _b) internal pure returns (uint256 v) {
v = _b;
// swap bytes
v = ((v >> 8) & 0x00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF) |
((v & 0x00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF00FF) << 8);
// swap 2-byte long pairs
v = ((v >> 16) & 0x0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF) |
((v & 0x0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF0000FFFF) << 16);
// swap 4-byte long pairs
v = ((v >> 32) & 0x00000000FFFFFFFF00000000FFFFFFFF00000000FFFFFFFF00000000FFFFFFFF) |
((v & 0x00000000FFFFFFFF00000000FFFFFFFF00000000FFFFFFFF00000000FFFFFFFF) << 32);
// swap 8-byte long pairs
v = ((v >> 64) & 0x0000000000000000FFFFFFFFFFFFFFFF0000000000000000FFFFFFFFFFFFFFFF) |
((v & 0x0000000000000000FFFFFFFFFFFFFFFF0000000000000000FFFFFFFFFFFFFFFF) << 64);
// swap 16-byte long pairs
v = (v >> 128) | (v << 128);
}
/**
* @notice Create a mask with the highest `_len` bits set.
* @param _len The length
* @return mask - The mask
*/
function leftMask(uint8 _len) private pure returns (uint256 mask) {
// ugly. redo without assembly?
assembly {
// solium-disable-previous-line security/no-inline-assembly
mask := sar(
sub(_len, 1),
0x8000000000000000000000000000000000000000000000000000000000000000
)
}
}
/**
* @notice Return the null view.
* @return bytes29 - The null view
*/
function nullView() internal pure returns (bytes29) {
return NULL;
}
/**
* @notice Check if the view is null.
* @return bool - True if the view is null
*/
function isNull(bytes29 memView) internal pure returns (bool) {
return memView == NULL;
}
/**
* @notice Check if the view is not null.
* @return bool - True if the view is not null
*/
function notNull(bytes29 memView) internal pure returns (bool) {
return !isNull(memView);
}
/**
* @notice Check if the view is of a valid type and points to a valid location
* in memory.
* @dev We perform this check by examining solidity's unallocated memory
* pointer and ensuring that the view's upper bound is less than that.
* @param memView The view
* @return ret - True if the view is valid
*/
function isValid(bytes29 memView) internal pure returns (bool ret) {
if (typeOf(memView) == 0xffffffffff) {return false;}
uint256 _end = end(memView);
assembly {
// solhint-disable-previous-line no-inline-assembly
ret := iszero(gt(_end, mload(0x40)))
}
}
/**
* @notice Require that a typed memory view be valid.
* @dev Returns the view for easy chaining.
* @param memView The view
* @return bytes29 - The validated view
*/
function assertValid(bytes29 memView) internal pure returns (bytes29) {
require(isValid(memView), "Validity assertion failed");
return memView;
}
/**
* @notice Return true if the memview is of the expected type. Otherwise false.
* @param memView The view
* @param _expected The expected type
* @return bool - True if the memview is of the expected type
*/
function isType(bytes29 memView, uint40 _expected) internal pure returns (bool) {
return typeOf(memView) == _expected;
}
/**
* @notice Require that a typed memory view has a specific type.
* @dev Returns the view for easy chaining.
* @param memView The view
* @param _expected The expected type
* @return bytes29 - The view with validated type
*/
function assertType(bytes29 memView, uint40 _expected) internal pure returns (bytes29) {
if (!isType(memView, _expected)) {
(, uint256 g) = encodeHex(uint256(typeOf(memView)));
(, uint256 e) = encodeHex(uint256(_expected));
string memory err = string(
abi.encodePacked(
"Type assertion failed. Got 0x",
uint80(g),
". Expected 0x",
uint80(e)
)
);
revert(err);
}
return memView;
}
/**
* @notice Return an identical view with a different type.
* @param memView The view
* @param _newType The new type
* @return newView - The new view with the specified type
*/
function castTo(bytes29 memView, uint40 _newType) internal pure returns (bytes29 newView) {
// then | in the new type
uint256 _typeShift = SHIFT_TO_TYPE;
uint256 _typeBits = 40;
assembly {
// solium-disable-previous-line security/no-inline-assembly
// shift off the top 5 bytes
newView := or(newView, shr(_typeBits, shl(_typeBits, memView)))
newView := or(newView, shl(_typeShift, _newType))
}
}
/**
* @notice Unsafe raw pointer construction. This should generally not be called
* directly. Prefer `ref` wherever possible.
* @dev Unsafe raw pointer construction. This should generally not be called
* directly. Prefer `ref` wherever possible.
* @param _type The type
* @param _loc The memory address
* @param _len The length
* @return newView - The new view with the specified type, location and length
*/
function unsafeBuildUnchecked(uint256 _type, uint256 _loc, uint256 _len) private pure returns (bytes29 newView) {
uint256 _uint96Bits = 96;
uint256 _emptyBits = 24;
assembly {
// solium-disable-previous-line security/no-inline-assembly
newView := shl(_uint96Bits, or(newView, _type)) // insert type
newView := shl(_uint96Bits, or(newView, _loc)) // insert loc
newView := shl(_emptyBits, or(newView, _len)) // empty bottom 3 bytes
}
}
/**
* @notice Instantiate a new memory view. This should generally not be called
* directly. Prefer `ref` wherever possible.
* @dev Instantiate a new memory view. This should generally not be called
* directly. Prefer `ref` wherever possible.
* @param _type The type
* @param _loc The memory address
* @param _len The length
* @return newView - The new view with the specified type, location and length
*/
function build(uint256 _type, uint256 _loc, uint256 _len) internal pure returns (bytes29 newView) {
uint256 _end = _loc.add(_len);
assembly {
// solium-disable-previous-line security/no-inline-assembly
if gt(_end, mload(0x40)) {
_end := 0
}
}
if (_end == 0) {
return NULL;
}
newView = unsafeBuildUnchecked(_type, _loc, _len);
}
/**
* @notice Instantiate a memory view from a byte array.
* @dev Note that due to Solidity memory representation, it is not possible to
* implement a deref, as the `bytes` type stores its len in memory.
* @param arr The byte array
* @param newType The type
* @return bytes29 - The memory view
*/
function ref(bytes memory arr, uint40 newType) internal pure returns (bytes29) {
uint256 _len = arr.length;
uint256 _loc;
assembly {
// solium-disable-previous-line security/no-inline-assembly
_loc := add(arr, 0x20) // our view is of the data, not the struct
}
return build(newType, _loc, _len);
}
/**
* @notice Return the associated type information.
* @param memView The memory view
* @return _type - The type associated with the view
*/
function typeOf(bytes29 memView) internal pure returns (uint40 _type) {
uint256 _shift = SHIFT_TO_TYPE;
assembly {
// solium-disable-previous-line security/no-inline-assembly
_type := shr(_shift, memView) // shift out lower 27 bytes
}
}
/**
* @notice Optimized type comparison. Checks that the 5-byte type flag is equal.
* @param left The first view
* @param right The second view
* @return bool - True if the 5-byte type flag is equal
*/
function sameType(bytes29 left, bytes29 right) internal pure returns (bool) {
return (left ^ right) >> SHIFT_TO_TYPE == 0;
}
/**
* @notice Return the memory address of the underlying bytes.
* @param memView The view
* @return _loc - The memory address
*/
function loc(bytes29 memView) internal pure returns (uint96 _loc) {
uint256 _mask = LOW_12_MASK; // assembly can't use globals
uint256 _shift = SHIFT_TO_LOC;
assembly {
// solium-disable-previous-line security/no-inline-assembly
_loc := and(shr(_shift, memView), _mask)
}
}
/**
* @notice The number of memory words this memory view occupies, rounded up.
* @param memView The view
* @return uint256 - The number of memory words
*/
function words(bytes29 memView) internal pure returns (uint256) {
return uint256(len(memView)).add(31) / 32;
}
/**
* @notice The in-memory footprint of a fresh copy of the view.
* @param memView The view
* @return uint256 - The in-memory footprint of a fresh copy of the view.
*/
function footprint(bytes29 memView) internal pure returns (uint256) {
return words(memView) * 32;
}
/**
* @notice The number of bytes of the view.
* @param memView The view
* @return _len - The length of the view
*/
function len(bytes29 memView) internal pure returns (uint96 _len) {
uint256 _mask = LOW_12_MASK; // assembly can't use globals
uint256 _emptyBits = 24;
assembly {
// solium-disable-previous-line security/no-inline-assembly
_len := and(shr(_emptyBits, memView), _mask)
}
}
/**
* @notice Returns the endpoint of `memView`.
* @param memView The view
* @return uint256 - The endpoint of `memView`
*/
function end(bytes29 memView) internal pure returns (uint256) {
return loc(memView) + len(memView);
}
/**
* @notice Safe slicing without memory modification.
* @param memView The view
* @param _index The start index
* @param _len The length
* @param newType The new type
* @return bytes29 - The new view
*/
function slice(bytes29 memView, uint256 _index, uint256 _len, uint40 newType) internal pure returns (bytes29) {
uint256 _loc = loc(memView);
// Ensure it doesn't overrun the view
if (_loc.add(_index).add(_len) > end(memView)) {
return NULL;
}
_loc = _loc.add(_index);
return build(newType, _loc, _len);
}
/**
* @notice Shortcut to `slice`. Gets a view representing the first `_len` bytes.
* @param memView The view
* @param _len The length
* @param newType The new type
* @return bytes29 - The new view
*/
function prefix(bytes29 memView, uint256 _len, uint40 newType) internal pure returns (bytes29) {
return slice(memView, 0, _len, newType);
}
/**
* @notice Shortcut to `slice`. Gets a view representing the last `_len` byte.
* @param memView The view
* @param _len The length
* @param newType The new type
* @return bytes29 - The new view
*/
function postfix(bytes29 memView, uint256 _len, uint40 newType) internal pure returns (bytes29) {
return slice(memView, uint256(len(memView)).sub(_len), _len, newType);
}
/**
* @notice Construct an error message for an indexing overrun.
* @param _loc The memory address
* @param _len The length
* @param _index The index
* @param _slice The slice where the overrun occurred
* @return err - The err
*/
function indexErrOverrun(
uint256 _loc,
uint256 _len,
uint256 _index,
uint256 _slice
) internal pure returns (string memory err) {
(, uint256 a) = encodeHex(_loc);
(, uint256 b) = encodeHex(_len);
(, uint256 c) = encodeHex(_index);
(, uint256 d) = encodeHex(_slice);
err = string(
abi.encodePacked(
"TypedMemView/index - Overran the view. Slice is at 0x",
uint48(a),
" with length 0x",
uint48(b),
". Attempted to index at offset 0x",
uint48(c),
" with length 0x",
uint48(d),
"."
)
);
}
/**
* @notice Load up to 32 bytes from the view onto the stack.
* @dev Returns a bytes32 with only the `_bytes` highest bytes set.
* This can be immediately cast to a smaller fixed-length byte array.
* To automatically cast to an integer, use `indexUint`.
* @param memView The view
* @param _index The index
* @param _bytes The bytes
* @return result - The 32 byte result
*/
function index(bytes29 memView, uint256 _index, uint8 _bytes) internal pure returns (bytes32 result) {
if (_bytes == 0) {return bytes32(0);}
if (_index.add(_bytes) > len(memView)) {
revert(indexErrOverrun(loc(memView), len(memView), _index, uint256(_bytes)));
}
require(_bytes <= 32, "TypedMemView/index - Attempted to index more than 32 bytes");
uint8 bitLength = _bytes * 8;
uint256 _loc = loc(memView);
uint256 _mask = leftMask(bitLength);
assembly {
// solium-disable-previous-line security/no-inline-assembly
result := and(mload(add(_loc, _index)), _mask)
}
}
/**
* @notice Parse an unsigned integer from the view at `_index`.
* @dev Requires that the view have >= `_bytes` bytes following that index.
* @param memView The view
* @param _index The index
* @param _bytes The bytes
* @return result - The unsigned integer
*/
function indexUint(bytes29 memView, uint256 _index, uint8 _bytes) internal pure returns (uint256 result) {
return uint256(index(memView, _index, _bytes)) >> ((32 - _bytes) * 8);
}
/**
* @notice Parse an unsigned integer from LE bytes.
* @param memView The view
* @param _index The index
* @param _bytes The bytes
* @return result - The unsigned integer
*/
function indexLEUint(bytes29 memView, uint256 _index, uint8 _bytes) internal pure returns (uint256 result) {
return reverseUint256(uint256(index(memView, _index, _bytes)));
}
/**
* @notice Parse an address from the view at `_index`. Requires that the view have >= 20 bytes
* following that index.
* @param memView The view
* @param _index The index
* @return address - The address
*/
function indexAddress(bytes29 memView, uint256 _index) internal pure returns (address) {
return address(uint160(indexUint(memView, _index, 20)));
}
/**
* @notice Return the keccak256 hash of the underlying memory
* @param memView The view
* @return digest - The keccak256 hash of the underlying memory
*/
function keccak(bytes29 memView) internal pure returns (bytes32 digest) {
uint256 _loc = loc(memView);
uint256 _len = len(memView);
assembly {
// solium-disable-previous-line security/no-inline-assembly
digest := keccak256(_loc, _len)
}
}
/**
* @notice Return the sha2 digest of the underlying memory.
* @dev We explicitly deallocate memory afterwards.
* @param memView The view
* @return digest - The sha2 hash of the underlying memory
*/
function sha2(bytes29 memView) internal view returns (bytes32 digest) {
uint256 _loc = loc(memView);
uint256 _len = len(memView);
bool res;
assembly {
// solium-disable-previous-line security/no-inline-assembly
let ptr := mload(0x40)
res := staticcall(gas(), 2, _loc, _len, ptr, 0x20) // sha2 #1
digest := mload(ptr)
}
require(res, "sha2 OOG");
}
/**
* @notice Implements bitcoin's hash160 (rmd160(sha2()))
* @param memView The pre-image
* @return digest - the Digest
*/
function hash160(bytes29 memView) internal view returns (bytes20 digest) {
uint256 _loc = loc(memView);
uint256 _len = len(memView);
bool res;
assembly {
// solium-disable-previous-line security/no-inline-assembly
let ptr := mload(0x40)
res := staticcall(gas(), 2, _loc, _len, ptr, 0x20) // sha2
res := and(res, staticcall(gas(), 3, ptr, 0x20, ptr, 0x20)) // rmd160
digest := mload(add(ptr, 0xc)) // return value is 0-prefixed.
}
require(res, "hash160 OOG");
}
/**
* @notice Implements bitcoin's hash256 (double sha2)
* @param memView A view of the preimage
* @return digest - the Digest
*/
function hash256(bytes29 memView) internal view returns (bytes32 digest) {
uint256 _loc = loc(memView);
uint256 _len = len(memView);
bool res;
assembly {
// solium-disable-previous-line security/no-inline-assembly
let ptr := mload(0x40)
res := staticcall(gas(), 2, _loc, _len, ptr, 0x20) // sha2 #1
res := and(res, staticcall(gas(), 2, ptr, 0x20, ptr, 0x20)) // sha2 #2
digest := mload(ptr)
}
require(res, "hash256 OOG");
}
/**
* @notice Return true if the underlying memory is equal. Else false.
* @param left The first view
* @param right The second view
* @return bool - True if the underlying memory is equal
*/
function untypedEqual(bytes29 left, bytes29 right) internal pure returns (bool) {
return (loc(left) == loc(right) && len(left) == len(right)) || keccak(left) == keccak(right);
}
/**
* @notice Return false if the underlying memory is equal. Else true.
* @param left The first view
* @param right The second view
* @return bool - False if the underlying memory is equal
*/
function untypedNotEqual(bytes29 left, bytes29 right) internal pure returns (bool) {
return !untypedEqual(left, right);
}
/**
* @notice Compares type equality.
* @dev Shortcuts if the pointers are identical, otherwise compares type and digest.
* @param left The first view
* @param right The second view
* @return bool - True if the types are the same
*/
function equal(bytes29 left, bytes29 right) internal pure returns (bool) {
return left == right || (typeOf(left) == typeOf(right) && keccak(left) == keccak(right));
}
/**
* @notice Compares type inequality.
* @dev Shortcuts if the pointers are identical, otherwise compares type and digest.
* @param left The first view
* @param right The second view
* @return bool - True if the types are not the same
*/
function notEqual(bytes29 left, bytes29 right) internal pure returns (bool) {
return !equal(left, right);
}
/**
* @notice Copy the view to a location, return an unsafe memory reference
* @dev Super Dangerous direct memory access.
*
* This reference can be overwritten if anything else modifies memory (!!!).
* As such it MUST be consumed IMMEDIATELY.
* This function is private to prevent unsafe usage by callers.
* @param memView The view
* @param _newLoc The new location
* @return written - the unsafe memory reference
*/
function unsafeCopyTo(bytes29 memView, uint256 _newLoc) private view returns (bytes29 written) {
require(notNull(memView), "TypedMemView/copyTo - Null pointer deref");
require(isValid(memView), "TypedMemView/copyTo - Invalid pointer deref");
uint256 _len = len(memView);
uint256 _oldLoc = loc(memView);
uint256 ptr;
bool res;
assembly {
// solium-disable-previous-line security/no-inline-assembly
ptr := mload(0x40)
// revert if we're writing in occupied memory
if gt(ptr, _newLoc) {
revert(0x60, 0x20) // empty revert message
}
// use the identity precompile to copy
res := staticcall(gas(), 4, _oldLoc, _len, _newLoc, _len)
}
require(res, "identity OOG");
written = unsafeBuildUnchecked(typeOf(memView), _newLoc, _len);
}
/**
* @notice Copies the referenced memory to a new loc in memory, returning a `bytes` pointing to
* the new memory
* @dev Shortcuts if the pointers are identical, otherwise compares type and digest.
* @param memView The view
* @return ret - The view pointing to the new memory
*/
function clone(bytes29 memView) internal view returns (bytes memory ret) {
uint256 ptr;
uint256 _len = len(memView);
assembly {
// solium-disable-previous-line security/no-inline-assembly
ptr := mload(0x40) // load unused memory pointer
ret := ptr
}
unsafeCopyTo(memView, ptr + 0x20);
assembly {
// solium-disable-previous-line security/no-inline-assembly
mstore(0x40, add(add(ptr, _len), 0x20)) // write new unused pointer
mstore(ptr, _len) // write len of new array (in bytes)
}
}
/**
* @notice Join the views in memory, return an unsafe reference to the memory.
* @dev Super Dangerous direct memory access.
*
* This reference can be overwritten if anything else modifies memory (!!!).
* As such it MUST be consumed IMMEDIATELY.
* This function is private to prevent unsafe usage by callers.
* @param memViews The views
* @param _location The location in memory to which to copy & concatenate
* @return unsafeView - The conjoined view pointing to the new memory
*/
function unsafeJoin(bytes29[] memory memViews, uint256 _location) private view returns (bytes29 unsafeView) {
assembly {
// solium-disable-previous-line security/no-inline-assembly
let ptr := mload(0x40)
// revert if we're writing in occupied memory
if gt(ptr, _location) {
revert(0x60, 0x20) // empty revert message
}
}
uint256 _offset = 0;
for (uint256 i = 0; i < memViews.length; i ++) {
bytes29 memView = memViews[i];
unsafeCopyTo(memView, _location + _offset);
_offset += len(memView);
}
unsafeView = unsafeBuildUnchecked(0, _location, _offset);
}
/**
* @notice Produce the keccak256 digest of the concatenated contents of multiple views.
* @param memViews The views
* @return bytes32 - The keccak256 digest
*/
function joinKeccak(bytes29[] memory memViews) internal view returns (bytes32) {
uint256 ptr;
assembly {
// solium-disable-previous-line security/no-inline-assembly
ptr := mload(0x40) // load unused memory pointer
}
return keccak(unsafeJoin(memViews, ptr));
}
/**
* @notice Produce the sha256 digest of the concatenated contents of multiple views.
* @param memViews The views
* @return bytes32 - The sha256 digest
*/
function joinSha2(bytes29[] memory memViews) internal view returns (bytes32) {
uint256 ptr;
assembly {
// solium-disable-previous-line security/no-inline-assembly
ptr := mload(0x40) // load unused memory pointer
}
return sha2(unsafeJoin(memViews, ptr));
}
/**
* @notice copies all views, joins them into a new bytearray.
* @param memViews The views
* @return ret - The new byte array
*/
function join(bytes29[] memory memViews) internal view returns (bytes memory ret) {
uint256 ptr;
assembly {
// solium-disable-previous-line security/no-inline-assembly
ptr := mload(0x40) // load unused memory pointer
}
bytes29 _newView = unsafeJoin(memViews, ptr + 0x20);
uint256 _written = len(_newView);
uint256 _footprint = footprint(_newView);
assembly {
// solium-disable-previous-line security/no-inline-assembly
// store the legnth
mstore(ptr, _written)
// new pointer is old + 0x20 + the footprint of the body
mstore(0x40, add(add(ptr, _footprint), 0x20))
ret := ptr
}
}
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
/**
* @title IMessageHandlerV2
* @notice Handles messages on the destination domain, forwarded from
* an IReceiverV2.
*/
interface IMessageHandlerV2 {
/**
* @notice Handles an incoming finalized message from an IReceiverV2
* @dev Finalized messages have finality threshold values greater than or equal to 2000
* @param sourceDomain The source domain of the message
* @param sender The sender of the message
* @param finalityThresholdExecuted the finality threshold at which the message was attested to
* @param messageBody The raw bytes of the message body
* @return success True, if successful; false, if not.
*/
function handleReceiveFinalizedMessage(
uint32 sourceDomain,
bytes32 sender,
uint32 finalityThresholdExecuted,
bytes calldata messageBody
) external returns (bool);
/**
* @notice Handles an incoming unfinalized message from an IReceiverV2
* @dev Unfinalized messages have finality threshold values less than 2000
* @param sourceDomain The source domain of the message
* @param sender The sender of the message
* @param finalityThresholdExecuted The finality threshold at which the message was attested to
* @param messageBody The raw bytes of the message body
* @return success True, if successful; false, if not.
*/
function handleReceiveUnfinalizedMessage(
uint32 sourceDomain,
bytes32 sender,
uint32 finalityThresholdExecuted,
bytes calldata messageBody
) external returns (bool);
}/* * Copyright 2024 Circle Internet Group, Inc. All rights reserved. * * SPDX-License-Identifier: Apache-2.0 * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ pragma solidity 0.7.6; // The threshold at which (and above) messages are considered finalized. uint32 constant FINALITY_THRESHOLD_FINALIZED = 2000; // The threshold at which (and above) messages are considered confirmed. uint32 constant FINALITY_THRESHOLD_CONFIRMED = 1000; // The minimum allowed level of finality accepted by TokenMessenger uint32 constant TOKEN_MESSENGER_MIN_FINALITY_THRESHOLD = 500;
/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {IReceiver} from "../IReceiver.sol";
/**
* @title IReceiverV2
* @notice Receives messages on the destination chain and forwards them to contracts implementing
* IMessageHandlerV2.
*/
interface IReceiverV2 is IReceiver {
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
/**
* @title IRelayerV2
* @notice Sends messages from the source domain to the destination domain
*/
interface IRelayerV2 {
/**
* @notice Sends an outgoing message from the source domain.
* @dev Emits a `MessageSent` event with message information.
* WARNING: if the `destinationCaller` does not represent a valid address as bytes32, then it will not be possible
* to broadcast the message on the destination domain. If set to bytes32(0), anyone will be able to broadcast it.
* This is an advanced feature, and using bytes32(0) should be preferred for use cases where a specific destination caller is not required.
* @param destinationDomain Domain of destination chain
* @param recipient Address of message recipient on destination domain as bytes32
* @param destinationCaller Allowed caller on destination domain (see above WARNING).
* @param minFinalityThreshold Minimum finality threshold at which the message must be attested to.
* @param messageBody Content of the message, as raw bytes
*/
function sendMessage(
uint32 destinationDomain,
bytes32 recipient,
bytes32 destinationCaller,
uint32 minFinalityThreshold,
bytes calldata messageBody
) external;
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {Attestable} from "../Attestable.sol";
/**
* @title AttestableV2
* @notice Builds on Attestable by adding a storage gap to enable more flexible future additions to
* any AttestableV2 child contracts.
*/
contract AttestableV2 is Attestable {
/**
* @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[20] private __gap;
// ============ Constructor ============
/**
* @dev The constructor sets the original attester manager and the first enabled attester to the
* msg.sender address.
*/
constructor() Attestable(msg.sender) {}
}/*
* Copyright (c) 2022, Circle Internet Financial Limited.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import "./Ownable2Step.sol";
/**
* @notice Base contract which allows children to implement an emergency stop
* mechanism
* @dev Forked from https://github.com/centrehq/centre-tokens/blob/0d3cab14ebd133a83fc834dbd48d0468bdf0b391/contracts/v1/Pausable.sol
* Modifications:
* 1. Update Solidity version from 0.6.12 to 0.7.6 (8/23/2022)
* 2. Change pauser visibility to private, declare external getter (11/19/22)
* 3. Add internal _updatePauser (10/8/2024)
*/
contract Pausable is Ownable2Step {
event Pause();
event Unpause();
event PauserChanged(address indexed newAddress);
address private _pauser;
bool public paused = false;
/**
* @dev Modifier to make a function callable only when the contract is not paused.
*/
modifier whenNotPaused() {
require(!paused, "Pausable: paused");
_;
}
/**
* @dev throws if called by any account other than the pauser
*/
modifier onlyPauser() {
require(msg.sender == _pauser, "Pausable: caller is not the pauser");
_;
}
/**
* @notice Returns current pauser
* @return Pauser's address
*/
function pauser() external view returns (address) {
return _pauser;
}
/**
* @dev called by the owner to pause, triggers stopped state
*/
function pause() external onlyPauser {
paused = true;
emit Pause();
}
/**
* @dev called by the owner to unpause, returns to normal state
*/
function unpause() external onlyPauser {
paused = false;
emit Unpause();
}
/**
* @dev update the pauser role
*/
function updatePauser(address _newPauser) external onlyOwner {
_updatePauser(_newPauser);
}
/**
* @dev update the pauser role
*/
function _updatePauser(address _newPauser) internal {
require(
_newPauser != address(0),
"Pausable: new pauser is the zero address"
);
_pauser = _newPauser;
emit PauserChanged(_pauser);
}
}/*
* Copyright (c) 2022, Circle Internet Financial Limited.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import "./Ownable2Step.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
/**
* @notice Base contract which allows children to rescue ERC20 locked in their contract.
* @dev Forked from https://github.com/centrehq/centre-tokens/blob/0d3cab14ebd133a83fc834dbd48d0468bdf0b391/contracts/v1.1/Rescuable.sol
* Modifications:
* 1. Update Solidity version from 0.6.12 to 0.7.6 (8/23/2022)
* 2. Add internal _updateRescuer (10/8/2024)
*/
contract Rescuable is Ownable2Step {
using SafeERC20 for IERC20;
address private _rescuer;
event RescuerChanged(address indexed newRescuer);
/**
* @notice Returns current rescuer
* @return Rescuer's address
*/
function rescuer() external view returns (address) {
return _rescuer;
}
/**
* @notice Revert if called by any account other than the rescuer.
*/
modifier onlyRescuer() {
require(msg.sender == _rescuer, "Rescuable: caller is not the rescuer");
_;
}
/**
* @notice Rescue ERC20 tokens locked up in this contract.
* @param tokenContract ERC20 token contract address
* @param to Recipient address
* @param amount Amount to withdraw
*/
function rescueERC20(
IERC20 tokenContract,
address to,
uint256 amount
) external onlyRescuer {
tokenContract.safeTransfer(to, amount);
}
/**
* @notice Assign the rescuer role to a given address.
* @param newRescuer New rescuer's address
*/
function updateRescuer(address newRescuer) external onlyOwner {
_updateRescuer(newRescuer);
}
/**
* @notice Assign the rescuer role to a given address.
* @param newRescuer New rescuer's address
*/
function _updateRescuer(address newRescuer) internal {
require(
newRescuer != address(0),
"Rescuable: new rescuer is the zero address"
);
_rescuer = newRescuer;
emit RescuerChanged(newRescuer);
}
}/*
* Copyright 2024 Circle Internet Group, Inc. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import {Address} from "@openzeppelin/contracts/utils/Address.sol";
/**
* @title Initializable
* @notice Base class to support implementation contracts behind a proxy
* @dev Forked from: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/3e6c86392c97fbc30d3d20a378a6f58beba08eba/contracts/proxy/utils/Initializable.sol
* Modifications (10/5/2024):
* - Pinned to Solidity 0.7.6
* - Replaced errors with revert strings
* - Replaced address.code call with Address.isContract for Solidity 0.7.6
*/
abstract contract Initializable {
/**
* @dev Storage of the initializable contract.
*
* It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions
* when using with upgradeable contracts.
*
* @custom:storage-location erc7201:openzeppelin.storage.Initializable
*/
struct InitializableStorage {
// Indicates that the contract has been initialized.
uint64 _initialized;
// Indicates that the contract is in the process of being initialized.
bool _initializing;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant INITIALIZABLE_STORAGE =
0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint64 version);
/**
* @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
* `onlyInitializing` functions can be used to initialize parent contracts.
*
* Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any
* number of times. This behavior in the constructor can be useful during testing and is not expected to be used in
* production.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
// solhint-disable-next-line var-name-mixedcase
InitializableStorage storage $ = _getInitializableStorage();
// Cache values to avoid duplicated sloads
bool isTopLevelCall = !$._initializing;
uint64 initialized = $._initialized;
// Allowed calls:
// - initialSetup: the contract is not in the initializing state and no previous version was
// initialized
// - construction: the contract is initialized at version 1 (no reininitialization) and the
// current contract is just being deployed
bool initialSetup = initialized == 0 && isTopLevelCall;
// 10/5/2024 fork: use Address.isContract instead of address(this).code.length for Solidity 0.7.6.
bool construction = initialized == 1 &&
!Address.isContract(address(this));
// 10/5/2024 fork: convert custom error to require statement
require(
initialSetup || construction,
"Initializable: invalid initialization"
);
$._initialized = 1;
if (isTopLevelCall) {
$._initializing = true;
}
_;
if (isTopLevelCall) {
$._initializing = false;
emit Initialized(1);
}
}
/**
* @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
* contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
* used to initialize parent contracts.
*
* A reinitializer may be used after the original initialization step. This is essential to configure modules that
* are added through upgrades and that require initialization.
*
* When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
* cannot be nested. If one is invoked in the context of another, execution will revert.
*
* Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
* a contract, executing them in the right order is up to the developer or operator.
*
* WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint64 version) {
// solhint-disable-next-line var-name-mixedcase
InitializableStorage storage $ = _getInitializableStorage();
// 10/5/2024 fork: convert custom error to require statement
require(
!$._initializing && $._initialized < version,
"Initializable: invalid initialization"
);
$._initialized = version;
$._initializing = true;
_;
$._initializing = false;
emit Initialized(version);
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} and {reinitializer} modifiers, directly or indirectly.
*/
modifier onlyInitializing() {
_checkInitializing();
_;
}
/**
* @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.
*/
function _checkInitializing() internal view virtual {
// 10/5/2024 fork: convert custom error to require statement
require(_isInitializing(), "Initializable: 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 {
// solhint-disable-next-line var-name-mixedcase
InitializableStorage storage $ = _getInitializableStorage();
// 10/5/2024 fork: convert custom error to require statement
require(!$._initializing, "Initializable: invalid initialization");
if ($._initialized != type(uint64).max) {
$._initialized = type(uint64).max;
emit Initialized(type(uint64).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint64) {
return _getInitializableStorage()._initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _getInitializableStorage()._initializing;
}
/**
* @dev Returns a pointer to the storage namespace.
*/
// solhint-disable-next-line var-name-mixedcase
function _getInitializableStorage()
private
pure
returns (InitializableStorage storage $)
{
assembly {
$.slot := INITIALIZABLE_STORAGE
}
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.5.10;
/*
The MIT License (MIT)
Copyright (c) 2016 Smart Contract Solutions, Inc.
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
/**
* @title SafeMath
* @dev Math operations with safety checks that throw on error
*/
library SafeMath {
/**
* @dev Multiplies two numbers, throws on overflow.
*/
function mul(uint256 _a, uint256 _b) internal pure returns (uint256 c) {
// Gas optimization: this is cheaper than asserting 'a' not being zero, but the
// benefit is lost if 'b' is also tested.
// See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
if (_a == 0) {
return 0;
}
c = _a * _b;
require(c / _a == _b, "Overflow during multiplication.");
return c;
}
/**
* @dev Integer division of two numbers, truncating the quotient.
*/
function div(uint256 _a, uint256 _b) internal pure returns (uint256) {
// assert(_b > 0); // Solidity automatically throws when dividing by 0
// uint256 c = _a / _b;
// assert(_a == _b * c + _a % _b); // There is no case in which this doesn't hold
return _a / _b;
}
/**
* @dev Subtracts two numbers, throws on overflow (i.e. if subtrahend is greater than minuend).
*/
function sub(uint256 _a, uint256 _b) internal pure returns (uint256) {
require(_b <= _a, "Underflow during subtraction.");
return _a - _b;
}
/**
* @dev Adds two numbers, throws on overflow.
*/
function add(uint256 _a, uint256 _b) internal pure returns (uint256 c) {
c = _a + _b;
require(c >= _a, "Overflow during addition.");
return c;
}
}/*
* Copyright (c) 2022, Circle Internet Financial Limited.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
/**
* @title IReceiver
* @notice Receives messages on destination chain and forwards them to IMessageDestinationHandler
*/
interface IReceiver {
/**
* @notice Receives an incoming message, validating the header and passing
* the body to application-specific handler.
* @param message The message raw bytes
* @param signature The message signature
* @return success bool, true if successful
*/
function receiveMessage(bytes calldata message, bytes calldata signature)
external
returns (bool success);
}/*
* Copyright (c) 2022, Circle Internet Financial Limited.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import "@openzeppelin/contracts/utils/EnumerableSet.sol";
import "@openzeppelin/contracts/cryptography/ECDSA.sol";
import "./Ownable2Step.sol";
contract Attestable is Ownable2Step {
// ============ Events ============
/**
* @notice Emitted when an attester is enabled
* @param attester newly enabled attester
*/
event AttesterEnabled(address indexed attester);
/**
* @notice Emitted when an attester is disabled
* @param attester newly disabled attester
*/
event AttesterDisabled(address indexed attester);
/**
* @notice Emitted when threshold number of attestations (m in m/n multisig) is updated
* @param oldSignatureThreshold old signature threshold
* @param newSignatureThreshold new signature threshold
*/
event SignatureThresholdUpdated(
uint256 oldSignatureThreshold,
uint256 newSignatureThreshold
);
/**
* @dev Emitted when attester manager address is updated
* @param previousAttesterManager representing the address of the previous attester manager
* @param newAttesterManager representing the address of the new attester manager
*/
event AttesterManagerUpdated(
address indexed previousAttesterManager,
address indexed newAttesterManager
);
// ============ Libraries ============
using EnumerableSet for EnumerableSet.AddressSet;
// ============ State Variables ============
// number of signatures from distinct attesters required for a message to be received (m in m/n multisig)
uint256 public signatureThreshold;
// 65-byte ECDSA signature: v (32) + r (32) + s (1)
uint256 internal constant signatureLength = 65;
// enabled attesters (message signers)
// (length of enabledAttesters is n in m/n multisig of message signers)
EnumerableSet.AddressSet private enabledAttesters;
// Attester Manager of the contract
address private _attesterManager;
// ============ Modifiers ============
/**
* @dev Throws if called by any account other than the attester manager.
*/
modifier onlyAttesterManager() {
require(msg.sender == _attesterManager, "Caller not attester manager");
_;
}
// ============ Constructor ============
/**
* @dev The constructor sets the original attester manager of the contract to the sender account.
* @param attester attester to initialize
*/
constructor(address attester) {
_setAttesterManager(msg.sender);
// Initially 1 signature is required. Threshold can be increased by attesterManager.
signatureThreshold = 1;
enableAttester(attester);
}
// ============ Public/External Functions ============
/**
* @notice Enables an attester
* @dev Only callable by attesterManager. New attester must be nonzero, and currently disabled.
* @param newAttester attester to enable
*/
function enableAttester(address newAttester) public onlyAttesterManager {
_enableAttester(newAttester);
}
/**
* @notice returns true if given `attester` is enabled, else false
* @param attester attester to check enabled status of
* @return true if given `attester` is enabled, else false
*/
function isEnabledAttester(address attester) public view returns (bool) {
return enabledAttesters.contains(attester);
}
/**
* @notice returns the number of enabled attesters
* @return number of enabled attesters
*/
function getNumEnabledAttesters() public view returns (uint256) {
return enabledAttesters.length();
}
/**
* @dev Allows the current attester manager to transfer control of the contract to a newAttesterManager.
* @param newAttesterManager The address to update attester manager to.
*/
function updateAttesterManager(
address newAttesterManager
) external onlyOwner {
_setAttesterManager(newAttesterManager);
}
/**
* @notice Disables an attester
* @dev Only callable by attesterManager. Disabling the attester is not allowed if there is only one attester
* enabled, or if it would cause the number of enabled attesters to become less than signatureThreshold.
* (Attester must be currently enabled.)
* @param attester attester to disable
*/
function disableAttester(address attester) external onlyAttesterManager {
// Disallow disabling attester if there is only 1 active attester
uint256 _numEnabledAttesters = getNumEnabledAttesters();
require(_numEnabledAttesters > 1, "Too few enabled attesters");
// Disallow disabling an attester if it would cause the n in m/n multisig to fall below m (threshold # of signers).
require(
_numEnabledAttesters > signatureThreshold,
"Signature threshold is too low"
);
require(enabledAttesters.remove(attester), "Attester already disabled");
emit AttesterDisabled(attester);
}
/**
* @notice Sets the threshold of signatures required to attest to a message.
* (This is the m in m/n multisig.)
* @dev new signature threshold must be nonzero, and must not exceed number
* of enabled attesters.
* @param newSignatureThreshold new signature threshold
*/
function setSignatureThreshold(
uint256 newSignatureThreshold
) external onlyAttesterManager {
_setSignatureThreshold(newSignatureThreshold);
}
/**
* @dev Returns the address of the attester manager
* @return address of the attester manager
*/
function attesterManager() external view returns (address) {
return _attesterManager;
}
/**
* @notice gets enabled attester at given `index`
* @param index index of attester to check
* @return enabled attester at given `index`
*/
function getEnabledAttester(uint256 index) external view returns (address) {
return enabledAttesters.at(index);
}
// ============ Internal Utils ============
/**
* @dev Sets a new attester manager address
* @dev Emits an {AttesterManagerUpdated} event
* @dev Reverts if _newAttesterManager is the zero address
* @param _newAttesterManager attester manager address to set
*/
function _setAttesterManager(address _newAttesterManager) internal {
require(
_newAttesterManager != address(0),
"Invalid attester manager address"
);
address _oldAttesterManager = _attesterManager;
_attesterManager = _newAttesterManager;
emit AttesterManagerUpdated(_oldAttesterManager, _newAttesterManager);
}
/**
* @notice Enables an attester
* @dev New attester must be nonzero, and currently disabled.
* @param _newAttester attester to enable
*/
function _enableAttester(address _newAttester) internal {
require(_newAttester != address(0), "New attester must be nonzero");
require(enabledAttesters.add(_newAttester), "Attester already enabled");
emit AttesterEnabled(_newAttester);
}
/**
* @notice reverts if the attestation, which is comprised of one or more concatenated 65-byte signatures, is invalid.
* @dev Rules for valid attestation:
* 1. length of `_attestation` == 65 (signature length) * signatureThreshold
* 2. addresses recovered from attestation must be in increasing order.
* For example, if signature A is signed by address 0x1..., and signature B
* is signed by address 0x2..., attestation must be passed as AB.
* 3. no duplicate signers
* 4. all signers must be enabled attesters
*
* Based on Christian Lundkvist's Simple Multisig
* (https://github.com/christianlundkvist/simple-multisig/tree/560c463c8651e0a4da331bd8f245ccd2a48ab63d)
* @param _message message to verify attestation of
* @param _attestation attestation of `_message`
*/
function _verifyAttestationSignatures(
bytes calldata _message,
bytes calldata _attestation
) internal view {
require(
_attestation.length == signatureLength * signatureThreshold,
"Invalid attestation length"
);
// (Attesters cannot be address(0))
address _latestAttesterAddress = address(0);
// Address recovered from signatures must be in increasing order, to prevent duplicates
bytes32 _digest = keccak256(_message);
for (uint256 i; i < signatureThreshold; ++i) {
bytes memory _signature = _attestation[i * signatureLength:i *
signatureLength +
signatureLength];
address _recoveredAttester = _recoverAttesterSignature(
_digest,
_signature
);
// Signatures must be in increasing order of address, and may not duplicate signatures from same address
require(
_recoveredAttester > _latestAttesterAddress,
"Invalid signature order or dupe"
);
require(
isEnabledAttester(_recoveredAttester),
"Invalid signature: not attester"
);
_latestAttesterAddress = _recoveredAttester;
}
}
/**
* @notice Checks that signature was signed by attester
* @param _digest message hash
* @param _signature message signature
* @return address of recovered signer
**/
function _recoverAttesterSignature(
bytes32 _digest,
bytes memory _signature
) internal pure returns (address) {
return (ECDSA.recover(_digest, _signature));
}
/**
* @notice Sets the threshold of signatures required to attest to a message.
* (This is the m in m/n multisig.)
* @dev New signature threshold must be nonzero, and must not exceed number
* of enabled attesters.
* @param _newSignatureThreshold new signature threshold
*/
function _setSignatureThreshold(uint256 _newSignatureThreshold) internal {
require(_newSignatureThreshold != 0, "Invalid signature threshold");
// New signature threshold cannot exceed the number of enabled attesters
require(
_newSignatureThreshold <= enabledAttesters.length(),
"New signature threshold too high"
);
require(
_newSignatureThreshold != signatureThreshold,
"Signature threshold already set"
);
uint256 _oldSignatureThreshold = signatureThreshold;
signatureThreshold = _newSignatureThreshold;
emit SignatureThresholdUpdated(
_oldSignatureThreshold,
_newSignatureThreshold
);
}
}/*
* Copyright (c) 2022, Circle Internet Financial Limited.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import "./Ownable.sol";
/**
* @dev forked from https://github.com/OpenZeppelin/openzeppelin-contracts/blob/7c5f6bc2c8743d83443fa46395d75f2f3f99054a/contracts/access/Ownable2Step.sol
* Modifications:
* 1. Update Solidity version from 0.8.0 to 0.7.6. Version 0.8.0 was used
* as base because this contract was added to OZ repo after version 0.8.0.
*
* 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 Ownable2Step is Ownable {
address private _pendingOwner;
event OwnershipTransferStarted(
address indexed previousOwner,
address indexed newOwner
);
/**
* @dev Returns the address of the pending owner.
*/
function pendingOwner() public view virtual returns (address) {
return _pendingOwner;
}
/**
* @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
* Can only be called by the current owner.
*/
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() external {
address sender = _msgSender();
require(
pendingOwner() == sender,
"Ownable2Step: caller is not the new owner"
);
_transferOwnership(sender);
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @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 `recipient`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address recipient, 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 `sender` to `recipient` 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 sender, address recipient, uint256 amount) external returns (bool);
/**
* @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);
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
import "./IERC20.sol";
import "../../math/SafeMath.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 SafeMath for uint256;
using Address for address;
function safeTransfer(IERC20 token, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(IERC20 token, address spender, uint256 value) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
// solhint-disable-next-line max-line-length
require((value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 newAllowance = token.allowance(address(this), spender).add(value);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
if (returndata.length > 0) { // Return data is optional
// solhint-disable-next-line max-line-length
require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.2 <0.8.0;
/**
* @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
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize, which returns 0 for contracts in
// construction, since the code is only stored at the end of the
// constructor execution.
uint256 size;
// solhint-disable-next-line no-inline-assembly
assembly { size := extcodesize(account) }
return size > 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://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
// solhint-disable-next-line avoid-low-level-calls, avoid-call-value
(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 functionCall(target, data, "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");
require(isContract(target), "Address: call to non-contract");
// solhint-disable-next-line avoid-low-level-calls
(bool success, bytes memory returndata) = target.call{ value: value }(data);
return _verifyCallResult(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) {
require(isContract(target), "Address: static call to non-contract");
// solhint-disable-next-line avoid-low-level-calls
(bool success, bytes memory returndata) = target.staticcall(data);
return _verifyCallResult(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) {
require(isContract(target), "Address: delegate call to non-contract");
// solhint-disable-next-line avoid-low-level-calls
(bool success, bytes memory returndata) = target.delegatecall(data);
return _verifyCallResult(success, returndata, errorMessage);
}
function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
if (success) {
return returndata;
} else {
// 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
// solhint-disable-next-line no-inline-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position of the value in the `values` array, plus 1 because index 0
// means a value is not in the set.
mapping (bytes32 => uint256) _indexes;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._indexes[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We read and store the value's index to prevent multiple reads from the same storage slot
uint256 valueIndex = set._indexes[value];
if (valueIndex != 0) { // Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 toDeleteIndex = valueIndex - 1;
uint256 lastIndex = set._values.length - 1;
// When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
// so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
bytes32 lastvalue = set._values[lastIndex];
// Move the last value to the index where the value to delete is
set._values[toDeleteIndex] = lastvalue;
// Update the index for the moved value
set._indexes[lastvalue] = toDeleteIndex + 1; // All indexes are 1-based
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the index for the deleted slot
delete set._indexes[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._indexes[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
require(set._values.length > index, "EnumerableSet: index out of bounds");
return set._values[index];
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
*
* These functions can be used to verify that a message was signed by the holder
* of the private keys of a given address.
*/
library ECDSA {
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature`. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*/
function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
// Check the signature length
if (signature.length != 65) {
revert("ECDSA: invalid signature length");
}
// Divide the signature in r, s and v variables
bytes32 r;
bytes32 s;
uint8 v;
// ecrecover takes the signature parameters, and the only way to get them
// currently is to use assembly.
// solhint-disable-next-line no-inline-assembly
assembly {
r := mload(add(signature, 0x20))
s := mload(add(signature, 0x40))
v := byte(0, mload(add(signature, 0x60)))
}
return recover(hash, v, r, s);
}
/**
* @dev Overload of {ECDSA-recover-bytes32-bytes-} that receives the `v`,
* `r` and `s` signature fields separately.
*/
function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
// EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
// unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
// the valid range for s in (281): 0 < s < secp256k1n ÷ 2 + 1, and for v in (282): v ∈ {27, 28}. Most
// signatures from current libraries generate a unique signature with an s-value in the lower half order.
//
// If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
// with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
// vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
// these malleable signatures as well.
require(uint256(s) <= 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0, "ECDSA: invalid signature 's' value");
require(v == 27 || v == 28, "ECDSA: invalid signature 'v' value");
// If the signature is valid (and not malleable), return the signer address
address signer = ecrecover(hash, v, r, s);
require(signer != address(0), "ECDSA: invalid signature");
return signer;
}
/**
* @dev Returns an Ethereum Signed Message, created from a `hash`. This
* replicates the behavior of the
* https://github.com/ethereum/wiki/wiki/JSON-RPC#eth_sign[`eth_sign`]
* JSON-RPC method.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
// 32 is the length in bytes of hash,
// enforced by the type signature above
return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
}
}/*
* Copyright (c) 2022, Circle Internet Financial Limited.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
pragma solidity 0.7.6;
import "@openzeppelin/contracts/utils/Context.sol";
/**
* @dev forked from https://github.com/OpenZeppelin/openzeppelin-contracts/blob/7c5f6bc2c8743d83443fa46395d75f2f3f99054a/contracts/access/Ownable.sol
* Modifications:
* 1. Update Solidity version from 0.8.0 to 0.7.6 (11/9/2022). (v8 was used
* as base because it includes internal _transferOwnership method.)
* 2. Remove renounceOwnership function
*
* Description
* Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
event OwnershipTransferred(
address indexed previousOwner,
address indexed newOwner
);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
constructor() {
_transferOwnership(_msgSender());
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
}
/**
* @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);
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Wrappers over Solidity's arithmetic operations with added overflow
* checks.
*
* Arithmetic operations in Solidity wrap on overflow. This can easily result
* in bugs, because programmers usually assume that an overflow raises an
* error, which is the standard behavior in high level programming languages.
* `SafeMath` restores this intuition by reverting the transaction when an
* operation overflows.
*
* Using this library instead of the unchecked operations eliminates an entire
* class of bugs, so it's recommended to use it always.
*/
library SafeMath {
/**
* @dev Returns the addition of two unsigned integers, with an overflow flag.
*
* _Available since v3.4._
*/
function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
uint256 c = a + b;
if (c < a) return (false, 0);
return (true, c);
}
/**
* @dev Returns the substraction of two unsigned integers, with an overflow flag.
*
* _Available since v3.4._
*/
function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
if (b > a) return (false, 0);
return (true, a - b);
}
/**
* @dev Returns the multiplication of two unsigned integers, with an overflow flag.
*
* _Available since v3.4._
*/
function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
// Gas optimization: this is cheaper than requiring 'a' not being zero, but the
// benefit is lost if 'b' is also tested.
// See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
if (a == 0) return (true, 0);
uint256 c = a * b;
if (c / a != b) return (false, 0);
return (true, c);
}
/**
* @dev Returns the division of two unsigned integers, with a division by zero flag.
*
* _Available since v3.4._
*/
function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
if (b == 0) return (false, 0);
return (true, a / b);
}
/**
* @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
*
* _Available since v3.4._
*/
function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
if (b == 0) return (false, 0);
return (true, a % b);
}
/**
* @dev Returns the addition of two unsigned integers, reverting on
* overflow.
*
* Counterpart to Solidity's `+` operator.
*
* Requirements:
*
* - Addition cannot overflow.
*/
function add(uint256 a, uint256 b) internal pure returns (uint256) {
uint256 c = a + b;
require(c >= a, "SafeMath: addition overflow");
return c;
}
/**
* @dev Returns the subtraction of two unsigned integers, reverting on
* overflow (when the result is negative).
*
* Counterpart to Solidity's `-` operator.
*
* Requirements:
*
* - Subtraction cannot overflow.
*/
function sub(uint256 a, uint256 b) internal pure returns (uint256) {
require(b <= a, "SafeMath: subtraction overflow");
return a - b;
}
/**
* @dev Returns the multiplication of two unsigned integers, reverting on
* overflow.
*
* Counterpart to Solidity's `*` operator.
*
* Requirements:
*
* - Multiplication cannot overflow.
*/
function mul(uint256 a, uint256 b) internal pure returns (uint256) {
if (a == 0) return 0;
uint256 c = a * b;
require(c / a == b, "SafeMath: multiplication overflow");
return c;
}
/**
* @dev Returns the integer division of two unsigned integers, reverting on
* division by zero. The result is rounded towards zero.
*
* Counterpart to Solidity's `/` operator. Note: this function uses a
* `revert` opcode (which leaves remaining gas untouched) while Solidity
* uses an invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function div(uint256 a, uint256 b) internal pure returns (uint256) {
require(b > 0, "SafeMath: division by zero");
return a / b;
}
/**
* @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
* reverting when dividing by zero.
*
* Counterpart to Solidity's `%` operator. This function uses a `revert`
* opcode (which leaves remaining gas untouched) while Solidity uses an
* invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function mod(uint256 a, uint256 b) internal pure returns (uint256) {
require(b > 0, "SafeMath: modulo by zero");
return a % b;
}
/**
* @dev Returns the subtraction of two unsigned integers, reverting with custom message on
* overflow (when the result is negative).
*
* CAUTION: This function is deprecated because it requires allocating memory for the error
* message unnecessarily. For custom revert reasons use {trySub}.
*
* Counterpart to Solidity's `-` operator.
*
* Requirements:
*
* - Subtraction cannot overflow.
*/
function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
require(b <= a, errorMessage);
return a - b;
}
/**
* @dev Returns the integer division of two unsigned integers, reverting with custom message on
* division by zero. The result is rounded towards zero.
*
* CAUTION: This function is deprecated because it requires allocating memory for the error
* message unnecessarily. For custom revert reasons use {tryDiv}.
*
* Counterpart to Solidity's `/` operator. Note: this function uses a
* `revert` opcode (which leaves remaining gas untouched) while Solidity
* uses an invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
require(b > 0, errorMessage);
return a / b;
}
/**
* @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
* reverting with custom message when dividing by zero.
*
* CAUTION: This function is deprecated because it requires allocating memory for the error
* message unnecessarily. For custom revert reasons use {tryMod}.
*
* Counterpart to Solidity's `%` operator. This function uses a `revert`
* opcode (which leaves remaining gas untouched) while Solidity uses an
* invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
require(b > 0, errorMessage);
return a % b;
}
}// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/*
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with GSN meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address payable) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes memory) {
this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
return msg.data;
}
}{
"remappings": [
"@memview-sol/=lib/memview-sol/",
"@openzeppelin/=lib/openzeppelin-contracts/",
"ds-test/=lib/ds-test/src/",
"forge-std/=lib/forge-std/src/",
"centre-tokens.git/=lib/centre-tokens.git/",
"memview-sol/=lib/memview-sol/contracts/",
"openzeppelin-contracts/=lib/openzeppelin-contracts/contracts/"
],
"optimizer": {
"enabled": true,
"runs": 100000
},
"metadata": {
"useLiteralContent": false,
"bytecodeHash": "ipfs"
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"evmVersion": "istanbul",
"viaIR": false
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"uint32","name":"_localDomain","type":"uint32"},{"internalType":"uint32","name":"_version","type":"uint32"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"attester","type":"address"}],"name":"AttesterDisabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"attester","type":"address"}],"name":"AttesterEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousAttesterManager","type":"address"},{"indexed":true,"internalType":"address","name":"newAttesterManager","type":"address"}],"name":"AttesterManagerUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newMaxMessageBodySize","type":"uint256"}],"name":"MaxMessageBodySizeUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":false,"internalType":"uint32","name":"sourceDomain","type":"uint32"},{"indexed":true,"internalType":"bytes32","name":"nonce","type":"bytes32"},{"indexed":false,"internalType":"bytes32","name":"sender","type":"bytes32"},{"indexed":true,"internalType":"uint32","name":"finalityThresholdExecuted","type":"uint32"},{"indexed":false,"internalType":"bytes","name":"messageBody","type":"bytes"}],"name":"MessageReceived","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bytes","name":"message","type":"bytes"}],"name":"MessageSent","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[],"name":"Pause","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"newAddress","type":"address"}],"name":"PauserChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"newRescuer","type":"address"}],"name":"RescuerChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"oldSignatureThreshold","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newSignatureThreshold","type":"uint256"}],"name":"SignatureThresholdUpdated","type":"event"},{"anonymous":false,"inputs":[],"name":"Unpause","type":"event"},{"inputs":[],"name":"NONCE_USED","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"attesterManager","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"attester","type":"address"}],"name":"disableAttester","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newAttester","type":"address"}],"name":"enableAttester","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getEnabledAttester","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getNumEnabledAttesters","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner_","type":"address"},{"internalType":"address","name":"pauser_","type":"address"},{"internalType":"address","name":"rescuer_","type":"address"},{"internalType":"address","name":"attesterManager_","type":"address"},{"internalType":"address[]","name":"attesters_","type":"address[]"},{"internalType":"uint256","name":"signatureThreshold_","type":"uint256"},{"internalType":"uint256","name":"maxMessageBodySize_","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"initializedVersion","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"attester","type":"address"}],"name":"isEnabledAttester","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"localDomain","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxMessageBodySize","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pauser","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"message","type":"bytes"},{"internalType":"bytes","name":"attestation","type":"bytes"}],"name":"receiveMessage","outputs":[{"internalType":"bool","name":"success","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"tokenContract","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"rescueERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rescuer","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"destinationDomain","type":"uint32"},{"internalType":"bytes32","name":"recipient","type":"bytes32"},{"internalType":"bytes32","name":"destinationCaller","type":"bytes32"},{"internalType":"uint32","name":"minFinalityThreshold","type":"uint32"},{"internalType":"bytes","name":"messageBody","type":"bytes"}],"name":"sendMessage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxMessageBodySize","type":"uint256"}],"name":"setMaxMessageBodySize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newSignatureThreshold","type":"uint256"}],"name":"setSignatureThreshold","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"signatureThreshold","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newAttesterManager","type":"address"}],"name":"updateAttesterManager","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_newPauser","type":"address"}],"name":"updatePauser","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newRescuer","type":"address"}],"name":"updateRescuer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"usedNonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"}]Contract Creation Code
60c06040526002805460ff60a01b191690553480156200001e57600080fd5b506040516200470638038062004706833981810160405260408110156200004457600080fd5b508051602090910151818133620000646200005e620000ab565b620000af565b6200006f33620000d9565b60016004556200007f8162000187565b506001600160e01b031960e092831b8116608052911b1660a052620000a3620001f2565b5050620004ac565b3390565b600180546001600160a01b0319169055620000d681620002b1602090811b62001abc17901c565b50565b6001600160a01b03811662000135576040805162461bcd60e51b815260206004820181905260248201527f496e76616c6964206174746573746572206d616e616765722061646472657373604482015290519081900360640190fd5b600780546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f0cee1b7ae04f3c788dd3a46c6fa677eb95b913611ef7ab59524fdc09d346021990600090a35050565b6007546001600160a01b03163314620001e7576040805162461bcd60e51b815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b620000d68162000301565b6000620001fe62000401565b805490915068010000000000000000900460ff1615620002505760405162461bcd60e51b8152600401808060200182810382526025815260200180620046e16025913960400191505060405180910390fd5b80546001600160401b0390811614620000d65780546001600160401b0319166001600160401b03908117825560408051918252517fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29181900360200190a150565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6001600160a01b0381166200035d576040805162461bcd60e51b815260206004820152601c60248201527f4e6577206174746573746572206d757374206265206e6f6e7a65726f00000000604482015290519081900360640190fd5b620003788160056200042560201b62001b311790919060201c565b620003ca576040805162461bcd60e51b815260206004820152601860248201527f417474657374657220616c726561647920656e61626c65640000000000000000604482015290519081900360640190fd5b6040516001600160a01b038216907f5b99bab45c72ce67e89466dbc47480b9c1fde1400e7268bbf463b8354ee4653f90600090a250565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0090565b60006200043c836001600160a01b03841662000445565b90505b92915050565b600062000453838362000494565b6200048b575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556200043f565b5060006200043f565b60009081526001919091016020526040902054151590565b60805160e01c60a05160e01c6141f2620004ef600039806109305280610d4e52806120fb5250806107a6528061095152806117915280611f6552506141f26000f3fe608060405234801561001057600080fd5b50600436106101e55760003560e01c80638456cb591161010f578063b2118a8d116100a2578063e30c397811610071578063e30c397814610680578063f2fde38b14610688578063fae36879146106bb578063feb61724146106ee576101e5565b8063b2118a8d146105d0578063bbde537414610613578063beb673d814610630578063de7769d41461064d576101e5565b80639b0d94b7116100de5780639b0d94b7146105b05780639fd0506d146105b8578063a82f2e26146105c0578063af47b9bb146105c8576101e5565b80638456cb591461057b5780638d3638f4146105835780638da5cb5b1461058b57806392492c6814610593576101e5565b806354fd4d50116101875780635f747e7d116101565780635f747e7d1461048d57806379ba5097146105385780637af82f60146105405780637de25ae414610573576101e5565b806354fd4d501461035b578063554bab3c1461037c57806357ecfd28146103af5780635c975abb14610485576101e5565b80632d025080116101c35780632d025080146102d557806338a63183146103085780633f4ba83a1461033957806351079a5314610341576101e5565b806308828eb7146101ea57806314b157ab1461020f5780632ab60045146102a2575b600080fd5b6101f261070b565b6040805167ffffffffffffffff9092168252519081900360200190f35b6102a0600480360360a081101561022557600080fd5b63ffffffff8235811692602081013592604082013592606083013516919081019060a08101608082013564010000000081111561026157600080fd5b82018360208201111561027357600080fd5b8035906020019184600183028401116401000000008311171561029557600080fd5b50909250905061071a565b005b6102a0600480360360208110156102b857600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610a21565b6102a0600480360360208110156102eb57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610a35565b610310610c61565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6102a0610c7d565b610349610d40565b60408051918252519081900360200190f35b610363610d4c565b6040805163ffffffff9092168252519081900360200190f35b6102a06004803603602081101561039257600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610d70565b610471600480360360408110156103c557600080fd5b8101906020810181356401000000008111156103e057600080fd5b8201836020820111156103f257600080fd5b8035906020019184600183028401116401000000008311171561041457600080fd5b91939092909160208101903564010000000081111561043257600080fd5b82018360208201111561044457600080fd5b8035906020019184600183028401116401000000008311171561046657600080fd5b509092509050610d81565b604080519115158252519081900360200190f35b6104716111ee565b6102a0600480360360e08110156104a357600080fd5b73ffffffffffffffffffffffffffffffffffffffff823581169260208101358216926040820135831692606083013516919081019060a0810160808201356401000000008111156104f357600080fd5b82018360208201111561050557600080fd5b8035906020019184602083028401116401000000008311171561052757600080fd5b91935091508035906020013561120f565b6102a06115fb565b6104716004803603602081101561055657600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661169b565b6103496116b0565b6102a06116b5565b61036361178f565b6103106117b3565b6102a0600480360360208110156105a957600080fd5b50356117cf565b6103106117e0565b6103106117fc565b610349611818565b61034961181e565b6102a0600480360360608110156105e657600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135611824565b6102a06004803603602081101561062957600080fd5b50356118ba565b6103106004803603602081101561064657600080fd5b5035611949565b6102a06004803603602081101561066357600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16611956565b610310611967565b6102a06004803603602081101561069e57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16611983565b6102a0600480360360208110156106d157600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16611a1b565b6103496004803603602081101561070457600080fd5b5035611aaa565b6000610715611b5c565b905090565b60025474010000000000000000000000000000000000000000900460ff16156107a457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601060248201527f5061757361626c653a2070617573656400000000000000000000000000000000604482015290519081900360640190fd5b7f000000000000000000000000000000000000000000000000000000000000000063ffffffff168663ffffffff16141561083f57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601660248201527f446f6d61696e206973206c6f63616c20646f6d61696e00000000000000000000604482015290519081900360640190fd5b601c548111156108b057604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601d60248201527f4d65737361676520626f64792065786365656473206d61782073697a65000000604482015290519081900360640190fd5b8461091c57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f526563697069656e74206d757374206265206e6f6e7a65726f00000000000000604482015290519081900360640190fd5b600061092733611b76565b9050600061097c7f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000008a858b8b8b8b8b611b8f565b90507f8c5261668696ce22758910d05bab8f186d6eb247ceac2af2e82c7dc17669b036816040518080602001828103825283818151815260200191508051906020019080838360005b838110156109dd5781810151838201526020016109c5565b50505050905090810190601f168015610a0a5780820380516001836020036101000a031916815260200191505b509250505060405180910390a15050505050505050565b610a29611c42565b610a3281611cec565b50565b60075473ffffffffffffffffffffffffffffffffffffffff163314610abb57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b6000610ac5610d40565b905060018111610b3657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f546f6f2066657720656e61626c65642061747465737465727300000000000000604482015290519081900360640190fd5b6004548111610ba657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601e60248201527f5369676e6174757265207468726573686f6c6420697320746f6f206c6f770000604482015290519081900360640190fd5b610bb1600583611dc7565b610c1c57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f417474657374657220616c72656164792064697361626c656400000000000000604482015290519081900360640190fd5b60405173ffffffffffffffffffffffffffffffffffffffff8316907f78e573a18c75957b7cadaab01511aa1c19a659f06ecf53e01de37ed92d3261fc90600090a25050565b60035473ffffffffffffffffffffffffffffffffffffffff1690565b60025473ffffffffffffffffffffffffffffffffffffffff163314610ced576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260228152602001806140c16022913960400191505060405180910390fd5b600280547fffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff1690556040517f7805862f689e2f13df9f062ff482ad3ad112aca9e0847911ed832e158c525b3390600090a1565b60006107156005611de9565b7f000000000000000000000000000000000000000000000000000000000000000081565b610d78611c42565b610a3281611df4565b60025460009074010000000000000000000000000000000000000000900460ff1615610e0e57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601060248201527f5061757361626c653a2070617573656400000000000000000000000000000000604482015290519081900360640190fd5b600080600080600080610e238b8b8b8b611ed5565b6000868152601d6020526040902060019055949a509298509096509450925090506107d063ffffffff83161015610fb3578273ffffffffffffffffffffffffffffffffffffffff16637c92f219868685856040518563ffffffff1660e01b8152600401808563ffffffff1681526020018481526020018363ffffffff16815260200180602001828103825283818151815260200191508051906020019080838360005b83811015610ede578181015183820152602001610ec6565b50505050905090810190601f168015610f0b5780820380516001836020036101000a031916815260200191505b5095505050505050602060405180830381600087803b158015610f2d57600080fd5b505af1158015610f41573d6000803e3d6000fd5b505050506040513d6020811015610f5757600080fd5b5051610fae576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260288152602001806141956028913960400191505060405180910390fd5b61110d565b8273ffffffffffffffffffffffffffffffffffffffff166311cffb67868685856040518563ffffffff1660e01b8152600401808563ffffffff1681526020018481526020018363ffffffff16815260200180602001828103825283818151815260200191508051906020019080838360005b8381101561103d578181015183820152602001611025565b50505050905090810190601f16801561106a5780820380516001836020036101000a031916815260200191505b5095505050505050602060405180830381600087803b15801561108c57600080fd5b505af11580156110a0573d6000803e3d6000fd5b505050506040513d60208110156110b657600080fd5b505161110d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180613f8f6026913960400191505060405180910390fd5b8163ffffffff16863373ffffffffffffffffffffffffffffffffffffffff167fff48c13eda96b1cceacc6b9edeedc9e9db9d6226afbc30146b720c19d3addb1c888886604051808463ffffffff16815260200183815260200180602001828103825283818151815260200191508051906020019080838360005b8381101561119f578181015183820152602001611187565b50505050905090810190601f1680156111cc5780820380516001836020036101000a031916815260200191505b5094505050505060405180910390a4600196505050505050505b949350505050565b60025474010000000000000000000000000000000000000000900460ff1681565b6000611219612382565b805490915060ff68010000000000000000820416159067ffffffffffffffff166000811580156112465750825b905060008267ffffffffffffffff16600114801561126a5750611268306123a6565b155b905081806112755750805b6112ca576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526025815260200180613ef26025913960400191505060405180910390fd5b84547fffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000166001178555831561132b5784547fffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff16680100000000000000001785555b73ffffffffffffffffffffffffffffffffffffffff8d166113ad57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f4f776e657220697320746865207a65726f206164647265737300000000000000604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8a16611419576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260238152602001806140646023913960400191505060405180910390fd5b87871115611472576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526025815260200180613f6a6025913960400191505060405180910390fd5b600086116114e157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f4d61784d657373616765426f647953697a65206973207a65726f000000000000604482015290519081900360640190fd5b6114ea8d6123ac565b6114f38b611cec565b6114fc8c611df4565b6115058a6123dd565b61150e866124d6565b8760005b818110156115535761154b8b8b8381811061152957fe5b9050602002013573ffffffffffffffffffffffffffffffffffffffff16612511565b600101611512565b5061155d8861264d565b5060008052601d60205260017f0a51588b1664495f089dd83d2d26f247920f94a57a4a09f20cf068efc8f82bd45583156115ec5784547fffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff168555604080516001815290517fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29181900360200190a15b50505050505050505050505050565b60006116056127e9565b90508073ffffffffffffffffffffffffffffffffffffffff16611626611967565b73ffffffffffffffffffffffffffffffffffffffff1614611692576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526029815260200180613f176029913960400191505060405180910390fd5b610a32816123ac565b60006116a86005836127ed565b90505b919050565b600181565b60025473ffffffffffffffffffffffffffffffffffffffff163314611725576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260228152602001806140c16022913960400191505060405180910390fd5b600280547fffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff16740100000000000000000000000000000000000000001790556040517f6985a02210a168e66602d3235cb6db0e70f92b3ba4d376a33c0f3d9434bff62590600090a1565b7f000000000000000000000000000000000000000000000000000000000000000081565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b6117d7611c42565b610a32816124d6565b60075473ffffffffffffffffffffffffffffffffffffffff1690565b60025473ffffffffffffffffffffffffffffffffffffffff1690565b60045481565b601c5481565b60035473ffffffffffffffffffffffffffffffffffffffff163314611894576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260248152602001806140406024913960400191505060405180910390fd5b6118b573ffffffffffffffffffffffffffffffffffffffff8416838361280f565b505050565b60075473ffffffffffffffffffffffffffffffffffffffff16331461194057604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b610a328161264d565b60006116a860058361289c565b61195e611c42565b610a32816123dd565b60015473ffffffffffffffffffffffffffffffffffffffff1690565b61198b611c42565b600180547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83169081179091556119d66117b3565b73ffffffffffffffffffffffffffffffffffffffff167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60075473ffffffffffffffffffffffffffffffffffffffff163314611aa157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b610a3281612511565b601d6020526000908152604090205481565b6000805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000611b538373ffffffffffffffffffffffffffffffffffffffff84166128a8565b90505b92915050565b6000611b66612382565b5467ffffffffffffffff16905090565b73ffffffffffffffffffffffffffffffffffffffff1690565b60608989896000801b8a8a8a8a60008b8b604051602001808c63ffffffff1660e01b81526004018b63ffffffff1660e01b81526004018a63ffffffff1660e01b81526004018981526020018881526020018781526020018681526020018563ffffffff1660e01b81526004018463ffffffff1660e01b8152600401838380828437808301925050509b50505050505050505050505060405160208183030381529060405290509998505050505050505050565b611c4a6127e9565b73ffffffffffffffffffffffffffffffffffffffff16611c686117b3565b73ffffffffffffffffffffffffffffffffffffffff1614611cea57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b565b73ffffffffffffffffffffffffffffffffffffffff8116611d58576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602a815260200180613f40602a913960400191505060405180910390fd5b600380547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83169081179091556040517fe475e580d85111348e40d8ca33cfdd74c30fe1655c2d8537a13abc10065ffa5a90600090a250565b6000611b538373ffffffffffffffffffffffffffffffffffffffff84166128f2565b60006116a8826129d6565b73ffffffffffffffffffffffffffffffffffffffff8116611e60576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526028815260200180613eca6028913960400191505060405180910390fd5b600280547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83811691909117918290556040519116907fb80482a293ca2e013eda8683c9bd7fc8347cfdaeea5ede58cba46df502c2a60490600090a250565b60008060008060006060611eeb8a8a8a8a6129da565b6000611f3160008c8c8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152509293925050612bf79050565b9050611f5e7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612c1b565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016611fb07fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612d59565b63ffffffff161461202257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c69642064657374696e6174696f6e20646f6d61696e000000000000604482015290519081900360640190fd5b600061204f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612d8a565b146120f45761205d33611b76565b6120887fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612d8a565b146120f457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c69642063616c6c657220666f72206d657373616765000000000000604482015290519081900360640190fd5b63ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166121467fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612dbb565b63ffffffff16146121b857604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f496e76616c6964206d6573736167652076657273696f6e000000000000000000604482015290519081900360640190fd5b6121e37fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612deb565b6000818152601d60205260409020549097501561226157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601260248201527f4e6f6e636520616c726561647920757365640000000000000000000000000000604482015290519081900360640190fd5b61228c7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612e1c565b95506122b97fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612e4c565b94506122ee6122e97fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612e7d565b612eae565b935061231b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612eb1565b925061237261234b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612ee2565b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000016612f51565b9150509499939850945094509450565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0090565b3b151590565b600180547fffffffffffffffffffffffff0000000000000000000000000000000000000000169055610a3281611abc565b73ffffffffffffffffffffffffffffffffffffffff811661245f57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f496e76616c6964206174746573746572206d616e616765722061646472657373604482015290519081900360640190fd5b6007805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681179093556040519116919082907f0cee1b7ae04f3c788dd3a46c6fa677eb95b913611ef7ab59524fdc09d346021990600090a35050565b601c8190556040805182815290517fb13bf6bebed03d1b318e3ea32e4b2a3ad9f5e2312cdf340a2f4bbfaee39f928d9181900360200190a150565b73ffffffffffffffffffffffffffffffffffffffff811661259357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601c60248201527f4e6577206174746573746572206d757374206265206e6f6e7a65726f00000000604482015290519081900360640190fd5b61259e600582611b31565b61260957604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601860248201527f417474657374657220616c726561647920656e61626c65640000000000000000604482015290519081900360640190fd5b60405173ffffffffffffffffffffffffffffffffffffffff8216907f5b99bab45c72ce67e89466dbc47480b9c1fde1400e7268bbf463b8354ee4653f90600090a250565b806126b957604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f496e76616c6964207369676e6174757265207468726573686f6c640000000000604482015290519081900360640190fd5b6126c36005611de9565b81111561273157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4e6577207369676e6174757265207468726573686f6c6420746f6f2068696768604482015290519081900360640190fd5b6004548114156127a257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f5369676e6174757265207468726573686f6c6420616c72656164792073657400604482015290519081900360640190fd5b6004805490829055604080518281526020810184905281517f149153f58b4da003a8cfd4523709a202402182cb5aa335046911277a1be6eede929181900390910190a15050565b3390565b6000611b538373ffffffffffffffffffffffffffffffffffffffff8416612f95565b6040805173ffffffffffffffffffffffffffffffffffffffff8416602482015260448082018490528251808303909101815260649091019091526020810180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff167fa9059cbb000000000000000000000000000000000000000000000000000000001790526118b5908490612fad565b6000611b538383613085565b60006128b48383612f95565b6128ea57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155611b56565b506000611b56565b600081815260018301602052604081205480156129cc5783547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff808301919081019060009087908390811061294357fe5b906000526020600020015490508087600001848154811061296057fe5b60009182526020808320909101929092558281526001898101909252604090209084019055865487908061299057fe5b60019003818190600052602060002001600090559055866001016000878152602001908152602001600020600090556001945050505050611b56565b6000915050611b56565b5490565b6004546041028114612a4d57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c6964206174746573746174696f6e206c656e677468000000000000604482015290519081900360640190fd5b60008085856040518083838082843760405192018290039091209450600093505050505b600454811015612bee576000612a906041838102908101908789613e7f565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920182905250939450612ad39250869150849050613103565b90508473ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1611612b6f57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f496e76616c6964207369676e6174757265206f72646572206f72206475706500604482015290519081900360640190fd5b612b788161169b565b612be357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f496e76616c6964207369676e61747572653a206e6f7420617474657374657200604482015290519081900360640190fd5b935050600101612a71565b50505050505050565b815160009060208401612c1264ffffffffff8516828461310f565b95945050505050565b612c467fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216613170565b612cb157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601160248201527f4d616c666f726d6564206d657373616765000000000000000000000000000000604482015290519081900360640190fd5b6094612cde7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000083166131ad565b6bffffffffffffffffffffffff161015610a3257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c6964206d6573736167653a20746f6f2073686f7274000000000000604482015290519081900360640190fd5b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316600860046131c1565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316606c60206131e2565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000083168260046131c1565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316600c60206131e2565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000083166004806131c1565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316602c60206131e2565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316604c60206131e2565b90565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316609060046131c1565b60006116a8609480612f157fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000086166131ad565b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000861692916bffffffffffffffffffffffff910316600061338d565b6060600080612f5f846131ad565b6bffffffffffffffffffffffff1690506040519150819250612f84848360200161341d565b508181016020016040529052919050565b60009081526001919091016020526040902054151590565b600061300f826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65648152508573ffffffffffffffffffffffffffffffffffffffff166135c29092919063ffffffff16565b8051909150156118b55780806020019051602081101561302e57600080fd5b50516118b5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602a8152602001806140e3602a913960400191505060405180910390fd5b815460009082106130e1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180613ea86022913960400191505060405180910390fd5b8260000182815481106130f057fe5b9060005260206000200154905092915050565b6000611b5383836135d1565b60008061311c8484613661565b905060405181111561312c575060005b8061315a577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000915050613169565b6131658585856136d3565b9150505b9392505050565b600061317b826136e6565b64ffffffffff1664ffffffffff1415613196575060006116ab565b60006131a1836136ec565b60405110159392505050565b60181c6bffffffffffffffffffffffff1690565b60008160200360080260ff166131d88585856131e2565b901c949350505050565b600060ff82166131f457506000613169565b6131fd846131ad565b6bffffffffffffffffffffffff166132188460ff8516613661565b11156132f75761325961322a85613716565b6bffffffffffffffffffffffff16613241866131ad565b6bffffffffffffffffffffffff16858560ff1661372a565b6040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825283818151815260200191508051906020019080838360005b838110156132bc5781810151838201526020016132a4565b50505050905090810190601f1680156132e95780820380516001836020036101000a031916815260200191505b509250505060405180910390fd5b60208260ff161115613354576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603a815260200180614087603a913960400191505060405180910390fd5b60088202600061336386613716565b6bffffffffffffffffffffffff169050600061337e83613885565b91909501511695945050505050565b60008061339986613716565b6bffffffffffffffffffffffff1690506133b2866136ec565b6133c6856133c08489613661565b90613661565b11156133f5577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000009150506111e6565b6133ff8186613661565b90506134138364ffffffffff16828661310f565b9695505050505050565b6000613428836138ce565b61347d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602881526020018061410d6028913960400191505060405180910390fd5b61348683613170565b6134db576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602b815260200180614135602b913960400191505060405180910390fd5b60006134e6846131ad565b6bffffffffffffffffffffffff169050600061350185613716565b6bffffffffffffffffffffffff1690506000806040519150858211156135275760206060fd5b8386858560045afa90508061359d57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152600c60248201527f6964656e74697479204f4f470000000000000000000000000000000000000000604482015290519081900360640190fd5b6135b76135a9886136e6565b64ffffffffff1687866136d3565b979650505050505050565b60606111e684846000856138e0565b6000815160411461364357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e67746800604482015290519081900360640190fd5b60208201516040830151606084015160001a61341386828585613a8f565b81810182811015611b5657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f4f766572666c6f7720647572696e67206164646974696f6e2e00000000000000604482015290519081900360640190fd5b606092831b9190911790911b1760181b90565b60d81c90565b60006136f7826131ad565b61370083613716565b016bffffffffffffffffffffffff169050919050565b60781c6bffffffffffffffffffffffff1690565b6060600061373786613c7d565b915050600061374586613c7d565b915050600061375386613c7d565b915050600061376186613c7d565b915050838383836040516020018080614160603591397fffffffffffff000000000000000000000000000000000000000000000000000060d087811b821660358401527f2077697468206c656e6774682030780000000000000000000000000000000000603b84015286901b16604a8201526050016021613ffd82397fffffffffffff000000000000000000000000000000000000000000000000000060d094851b811660218301527f2077697468206c656e677468203078000000000000000000000000000000000060278301529290931b9091166036830152507f2e00000000000000000000000000000000000000000000000000000000000000603c82015260408051601d818403018152603d90920190529b9a5050505050505050505050565b7f80000000000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff9091011d90565b60006138d982613d51565b1592915050565b60608247101561393b576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180613fd76026913960400191505060405180910390fd5b613944856123a6565b6139af57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015290519081900360640190fd5b6000808673ffffffffffffffffffffffffffffffffffffffff1685876040518082805190602001908083835b60208310613a1857805182527fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe090920191602091820191016139db565b6001836020036101000a03801982511681845116808217855250505050505090500191505060006040518083038185875af1925050503d8060008114613a7a576040519150601f19603f3d011682016040523d82523d6000602084013e613a7f565b606091505b50915091506135b7828286613d79565b60007f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0821115613b0a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180613fb56022913960400191505060405180910390fd5b8360ff16601b1480613b1f57508360ff16601c145b613b74576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602281526020018061401e6022913960400191505060405180910390fd5b600060018686868660405160008152602001604052604051808581526020018460ff1681526020018381526020018281526020019450505050506020604051602081039080840390855afa158015613bd0573d6000803e3d6000fd5b50506040517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0015191505073ffffffffffffffffffffffffffffffffffffffff8116612c1257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601860248201527f45434453413a20696e76616c6964207369676e61747572650000000000000000604482015290519081900360640190fd5b600080601f5b600f8160ff161115613ce55760ff600882021684901c613ca281613df9565b61ffff16841793508160ff16601014613cbd57601084901b93505b507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff01613c83565b50600f5b60ff8160ff161015613d4b5760ff600882021684901c613d0881613df9565b61ffff16831792508160ff16600014613d2357601083901b92505b507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff01613ce9565b50915091565b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000009081161490565b60608315613d88575081613169565b825115613d985782518084602001fd5b6040517f08c379a00000000000000000000000000000000000000000000000000000000081526020600482018181528451602484015284518593919283926044019190850190808383600083156132bc5781810151838201526020016132a4565b6000613e0b60048360ff16901c613e29565b60ff161760081b62ffff0016613e2082613e29565b60ff1617919050565b6040805180820190915260108082527f30313233343536373839616263646566000000000000000000000000000000006020830152600091600f84169182908110613e7057fe5b016020015160f81c9392505050565b60008085851115613e8e578182fd5b83861115613e9a578182fd5b505082019391909203915056fe456e756d657261626c655365743a20696e646578206f7574206f6620626f756e64735061757361626c653a206e65772070617573657220697320746865207a65726f2061646472657373496e697469616c697a61626c653a20696e76616c696420696e697469616c697a6174696f6e4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206e6577206f776e6572526573637561626c653a206e6577207265736375657220697320746865207a65726f20616464726573735369676e6174757265207468726573686f6c6420657863656564732061747465737465727368616e646c655265636569766546696e616c697a65644d6573736167652829206661696c656445434453413a20696e76616c6964207369676e6174757265202773272076616c7565416464726573733a20696e73756666696369656e742062616c616e636520666f722063616c6c2e20417474656d7074656420746f20696e646578206174206f666673657420307845434453413a20696e76616c6964207369676e6174757265202776272076616c7565526573637561626c653a2063616c6c6572206973206e6f7420746865207265736375657241747465737465724d616e6167657220697320746865207a65726f206164647265737354797065644d656d566965772f696e646578202d20417474656d7074656420746f20696e646578206d6f7265207468616e2033322062797465735061757361626c653a2063616c6c6572206973206e6f7420746865207061757365725361666545524332303a204552433230206f7065726174696f6e20646964206e6f74207375636365656454797065644d656d566965772f636f7079546f202d204e756c6c20706f696e74657220646572656654797065644d656d566965772f636f7079546f202d20496e76616c696420706f696e74657220646572656654797065644d656d566965772f696e646578202d204f76657272616e2074686520766965772e20536c69636520697320617420307868616e646c6552656365697665556e66696e616c697a65644d6573736167652829206661696c6564a2646970667358221220a00165ce6e6796a53230fb3366595e0ea95a7bf3ce20f2ff3464ada879d3f15764736f6c63430007060033496e697469616c697a61626c653a20696e76616c696420696e697469616c697a6174696f6e00000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000001
Deployed Bytecode
0x608060405234801561001057600080fd5b50600436106101e55760003560e01c80638456cb591161010f578063b2118a8d116100a2578063e30c397811610071578063e30c397814610680578063f2fde38b14610688578063fae36879146106bb578063feb61724146106ee576101e5565b8063b2118a8d146105d0578063bbde537414610613578063beb673d814610630578063de7769d41461064d576101e5565b80639b0d94b7116100de5780639b0d94b7146105b05780639fd0506d146105b8578063a82f2e26146105c0578063af47b9bb146105c8576101e5565b80638456cb591461057b5780638d3638f4146105835780638da5cb5b1461058b57806392492c6814610593576101e5565b806354fd4d50116101875780635f747e7d116101565780635f747e7d1461048d57806379ba5097146105385780637af82f60146105405780637de25ae414610573576101e5565b806354fd4d501461035b578063554bab3c1461037c57806357ecfd28146103af5780635c975abb14610485576101e5565b80632d025080116101c35780632d025080146102d557806338a63183146103085780633f4ba83a1461033957806351079a5314610341576101e5565b806308828eb7146101ea57806314b157ab1461020f5780632ab60045146102a2575b600080fd5b6101f261070b565b6040805167ffffffffffffffff9092168252519081900360200190f35b6102a0600480360360a081101561022557600080fd5b63ffffffff8235811692602081013592604082013592606083013516919081019060a08101608082013564010000000081111561026157600080fd5b82018360208201111561027357600080fd5b8035906020019184600183028401116401000000008311171561029557600080fd5b50909250905061071a565b005b6102a0600480360360208110156102b857600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610a21565b6102a0600480360360208110156102eb57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610a35565b610310610c61565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6102a0610c7d565b610349610d40565b60408051918252519081900360200190f35b610363610d4c565b6040805163ffffffff9092168252519081900360200190f35b6102a06004803603602081101561039257600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610d70565b610471600480360360408110156103c557600080fd5b8101906020810181356401000000008111156103e057600080fd5b8201836020820111156103f257600080fd5b8035906020019184600183028401116401000000008311171561041457600080fd5b91939092909160208101903564010000000081111561043257600080fd5b82018360208201111561044457600080fd5b8035906020019184600183028401116401000000008311171561046657600080fd5b509092509050610d81565b604080519115158252519081900360200190f35b6104716111ee565b6102a0600480360360e08110156104a357600080fd5b73ffffffffffffffffffffffffffffffffffffffff823581169260208101358216926040820135831692606083013516919081019060a0810160808201356401000000008111156104f357600080fd5b82018360208201111561050557600080fd5b8035906020019184602083028401116401000000008311171561052757600080fd5b91935091508035906020013561120f565b6102a06115fb565b6104716004803603602081101561055657600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661169b565b6103496116b0565b6102a06116b5565b61036361178f565b6103106117b3565b6102a0600480360360208110156105a957600080fd5b50356117cf565b6103106117e0565b6103106117fc565b610349611818565b61034961181e565b6102a0600480360360608110156105e657600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135611824565b6102a06004803603602081101561062957600080fd5b50356118ba565b6103106004803603602081101561064657600080fd5b5035611949565b6102a06004803603602081101561066357600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16611956565b610310611967565b6102a06004803603602081101561069e57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16611983565b6102a0600480360360208110156106d157600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16611a1b565b6103496004803603602081101561070457600080fd5b5035611aaa565b6000610715611b5c565b905090565b60025474010000000000000000000000000000000000000000900460ff16156107a457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601060248201527f5061757361626c653a2070617573656400000000000000000000000000000000604482015290519081900360640190fd5b7f000000000000000000000000000000000000000000000000000000000000001263ffffffff168663ffffffff16141561083f57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601660248201527f446f6d61696e206973206c6f63616c20646f6d61696e00000000000000000000604482015290519081900360640190fd5b601c548111156108b057604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601d60248201527f4d65737361676520626f64792065786365656473206d61782073697a65000000604482015290519081900360640190fd5b8461091c57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f526563697069656e74206d757374206265206e6f6e7a65726f00000000000000604482015290519081900360640190fd5b600061092733611b76565b9050600061097c7f00000000000000000000000000000000000000000000000000000000000000017f00000000000000000000000000000000000000000000000000000000000000128a858b8b8b8b8b611b8f565b90507f8c5261668696ce22758910d05bab8f186d6eb247ceac2af2e82c7dc17669b036816040518080602001828103825283818151815260200191508051906020019080838360005b838110156109dd5781810151838201526020016109c5565b50505050905090810190601f168015610a0a5780820380516001836020036101000a031916815260200191505b509250505060405180910390a15050505050505050565b610a29611c42565b610a3281611cec565b50565b60075473ffffffffffffffffffffffffffffffffffffffff163314610abb57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b6000610ac5610d40565b905060018111610b3657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f546f6f2066657720656e61626c65642061747465737465727300000000000000604482015290519081900360640190fd5b6004548111610ba657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601e60248201527f5369676e6174757265207468726573686f6c6420697320746f6f206c6f770000604482015290519081900360640190fd5b610bb1600583611dc7565b610c1c57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f417474657374657220616c72656164792064697361626c656400000000000000604482015290519081900360640190fd5b60405173ffffffffffffffffffffffffffffffffffffffff8316907f78e573a18c75957b7cadaab01511aa1c19a659f06ecf53e01de37ed92d3261fc90600090a25050565b60035473ffffffffffffffffffffffffffffffffffffffff1690565b60025473ffffffffffffffffffffffffffffffffffffffff163314610ced576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260228152602001806140c16022913960400191505060405180910390fd5b600280547fffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff1690556040517f7805862f689e2f13df9f062ff482ad3ad112aca9e0847911ed832e158c525b3390600090a1565b60006107156005611de9565b7f000000000000000000000000000000000000000000000000000000000000000181565b610d78611c42565b610a3281611df4565b60025460009074010000000000000000000000000000000000000000900460ff1615610e0e57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601060248201527f5061757361626c653a2070617573656400000000000000000000000000000000604482015290519081900360640190fd5b600080600080600080610e238b8b8b8b611ed5565b6000868152601d6020526040902060019055949a509298509096509450925090506107d063ffffffff83161015610fb3578273ffffffffffffffffffffffffffffffffffffffff16637c92f219868685856040518563ffffffff1660e01b8152600401808563ffffffff1681526020018481526020018363ffffffff16815260200180602001828103825283818151815260200191508051906020019080838360005b83811015610ede578181015183820152602001610ec6565b50505050905090810190601f168015610f0b5780820380516001836020036101000a031916815260200191505b5095505050505050602060405180830381600087803b158015610f2d57600080fd5b505af1158015610f41573d6000803e3d6000fd5b505050506040513d6020811015610f5757600080fd5b5051610fae576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260288152602001806141956028913960400191505060405180910390fd5b61110d565b8273ffffffffffffffffffffffffffffffffffffffff166311cffb67868685856040518563ffffffff1660e01b8152600401808563ffffffff1681526020018481526020018363ffffffff16815260200180602001828103825283818151815260200191508051906020019080838360005b8381101561103d578181015183820152602001611025565b50505050905090810190601f16801561106a5780820380516001836020036101000a031916815260200191505b5095505050505050602060405180830381600087803b15801561108c57600080fd5b505af11580156110a0573d6000803e3d6000fd5b505050506040513d60208110156110b657600080fd5b505161110d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180613f8f6026913960400191505060405180910390fd5b8163ffffffff16863373ffffffffffffffffffffffffffffffffffffffff167fff48c13eda96b1cceacc6b9edeedc9e9db9d6226afbc30146b720c19d3addb1c888886604051808463ffffffff16815260200183815260200180602001828103825283818151815260200191508051906020019080838360005b8381101561119f578181015183820152602001611187565b50505050905090810190601f1680156111cc5780820380516001836020036101000a031916815260200191505b5094505050505060405180910390a4600196505050505050505b949350505050565b60025474010000000000000000000000000000000000000000900460ff1681565b6000611219612382565b805490915060ff68010000000000000000820416159067ffffffffffffffff166000811580156112465750825b905060008267ffffffffffffffff16600114801561126a5750611268306123a6565b155b905081806112755750805b6112ca576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526025815260200180613ef26025913960400191505060405180910390fd5b84547fffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000166001178555831561132b5784547fffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff16680100000000000000001785555b73ffffffffffffffffffffffffffffffffffffffff8d166113ad57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f4f776e657220697320746865207a65726f206164647265737300000000000000604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8a16611419576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260238152602001806140646023913960400191505060405180910390fd5b87871115611472576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526025815260200180613f6a6025913960400191505060405180910390fd5b600086116114e157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f4d61784d657373616765426f647953697a65206973207a65726f000000000000604482015290519081900360640190fd5b6114ea8d6123ac565b6114f38b611cec565b6114fc8c611df4565b6115058a6123dd565b61150e866124d6565b8760005b818110156115535761154b8b8b8381811061152957fe5b9050602002013573ffffffffffffffffffffffffffffffffffffffff16612511565b600101611512565b5061155d8861264d565b5060008052601d60205260017f0a51588b1664495f089dd83d2d26f247920f94a57a4a09f20cf068efc8f82bd45583156115ec5784547fffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff168555604080516001815290517fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29181900360200190a15b50505050505050505050505050565b60006116056127e9565b90508073ffffffffffffffffffffffffffffffffffffffff16611626611967565b73ffffffffffffffffffffffffffffffffffffffff1614611692576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526029815260200180613f176029913960400191505060405180910390fd5b610a32816123ac565b60006116a86005836127ed565b90505b919050565b600181565b60025473ffffffffffffffffffffffffffffffffffffffff163314611725576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260228152602001806140c16022913960400191505060405180910390fd5b600280547fffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff16740100000000000000000000000000000000000000001790556040517f6985a02210a168e66602d3235cb6db0e70f92b3ba4d376a33c0f3d9434bff62590600090a1565b7f000000000000000000000000000000000000000000000000000000000000001281565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b6117d7611c42565b610a32816124d6565b60075473ffffffffffffffffffffffffffffffffffffffff1690565b60025473ffffffffffffffffffffffffffffffffffffffff1690565b60045481565b601c5481565b60035473ffffffffffffffffffffffffffffffffffffffff163314611894576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260248152602001806140406024913960400191505060405180910390fd5b6118b573ffffffffffffffffffffffffffffffffffffffff8416838361280f565b505050565b60075473ffffffffffffffffffffffffffffffffffffffff16331461194057604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b610a328161264d565b60006116a860058361289c565b61195e611c42565b610a32816123dd565b60015473ffffffffffffffffffffffffffffffffffffffff1690565b61198b611c42565b600180547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83169081179091556119d66117b3565b73ffffffffffffffffffffffffffffffffffffffff167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60075473ffffffffffffffffffffffffffffffffffffffff163314611aa157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f43616c6c6572206e6f74206174746573746572206d616e616765720000000000604482015290519081900360640190fd5b610a3281612511565b601d6020526000908152604090205481565b6000805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000611b538373ffffffffffffffffffffffffffffffffffffffff84166128a8565b90505b92915050565b6000611b66612382565b5467ffffffffffffffff16905090565b73ffffffffffffffffffffffffffffffffffffffff1690565b60608989896000801b8a8a8a8a60008b8b604051602001808c63ffffffff1660e01b81526004018b63ffffffff1660e01b81526004018a63ffffffff1660e01b81526004018981526020018881526020018781526020018681526020018563ffffffff1660e01b81526004018463ffffffff1660e01b8152600401838380828437808301925050509b50505050505050505050505060405160208183030381529060405290509998505050505050505050565b611c4a6127e9565b73ffffffffffffffffffffffffffffffffffffffff16611c686117b3565b73ffffffffffffffffffffffffffffffffffffffff1614611cea57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b565b73ffffffffffffffffffffffffffffffffffffffff8116611d58576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602a815260200180613f40602a913960400191505060405180910390fd5b600380547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83169081179091556040517fe475e580d85111348e40d8ca33cfdd74c30fe1655c2d8537a13abc10065ffa5a90600090a250565b6000611b538373ffffffffffffffffffffffffffffffffffffffff84166128f2565b60006116a8826129d6565b73ffffffffffffffffffffffffffffffffffffffff8116611e60576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526028815260200180613eca6028913960400191505060405180910390fd5b600280547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83811691909117918290556040519116907fb80482a293ca2e013eda8683c9bd7fc8347cfdaeea5ede58cba46df502c2a60490600090a250565b60008060008060006060611eeb8a8a8a8a6129da565b6000611f3160008c8c8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152509293925050612bf79050565b9050611f5e7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612c1b565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000001216611fb07fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612d59565b63ffffffff161461202257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c69642064657374696e6174696f6e20646f6d61696e000000000000604482015290519081900360640190fd5b600061204f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612d8a565b146120f45761205d33611b76565b6120887fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612d8a565b146120f457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c69642063616c6c657220666f72206d657373616765000000000000604482015290519081900360640190fd5b63ffffffff7f0000000000000000000000000000000000000000000000000000000000000001166121467fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612dbb565b63ffffffff16146121b857604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f496e76616c6964206d6573736167652076657273696f6e000000000000000000604482015290519081900360640190fd5b6121e37fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612deb565b6000818152601d60205260409020549097501561226157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601260248201527f4e6f6e636520616c726561647920757365640000000000000000000000000000604482015290519081900360640190fd5b61228c7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612e1c565b95506122b97fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612e4c565b94506122ee6122e97fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612e7d565b612eae565b935061231b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216612eb1565b925061237261234b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316612ee2565b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000016612f51565b9150509499939850945094509450565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0090565b3b151590565b600180547fffffffffffffffffffffffff0000000000000000000000000000000000000000169055610a3281611abc565b73ffffffffffffffffffffffffffffffffffffffff811661245f57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f496e76616c6964206174746573746572206d616e616765722061646472657373604482015290519081900360640190fd5b6007805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681179093556040519116919082907f0cee1b7ae04f3c788dd3a46c6fa677eb95b913611ef7ab59524fdc09d346021990600090a35050565b601c8190556040805182815290517fb13bf6bebed03d1b318e3ea32e4b2a3ad9f5e2312cdf340a2f4bbfaee39f928d9181900360200190a150565b73ffffffffffffffffffffffffffffffffffffffff811661259357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601c60248201527f4e6577206174746573746572206d757374206265206e6f6e7a65726f00000000604482015290519081900360640190fd5b61259e600582611b31565b61260957604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601860248201527f417474657374657220616c726561647920656e61626c65640000000000000000604482015290519081900360640190fd5b60405173ffffffffffffffffffffffffffffffffffffffff8216907f5b99bab45c72ce67e89466dbc47480b9c1fde1400e7268bbf463b8354ee4653f90600090a250565b806126b957604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f496e76616c6964207369676e6174757265207468726573686f6c640000000000604482015290519081900360640190fd5b6126c36005611de9565b81111561273157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4e6577207369676e6174757265207468726573686f6c6420746f6f2068696768604482015290519081900360640190fd5b6004548114156127a257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f5369676e6174757265207468726573686f6c6420616c72656164792073657400604482015290519081900360640190fd5b6004805490829055604080518281526020810184905281517f149153f58b4da003a8cfd4523709a202402182cb5aa335046911277a1be6eede929181900390910190a15050565b3390565b6000611b538373ffffffffffffffffffffffffffffffffffffffff8416612f95565b6040805173ffffffffffffffffffffffffffffffffffffffff8416602482015260448082018490528251808303909101815260649091019091526020810180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff167fa9059cbb000000000000000000000000000000000000000000000000000000001790526118b5908490612fad565b6000611b538383613085565b60006128b48383612f95565b6128ea57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155611b56565b506000611b56565b600081815260018301602052604081205480156129cc5783547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff808301919081019060009087908390811061294357fe5b906000526020600020015490508087600001848154811061296057fe5b60009182526020808320909101929092558281526001898101909252604090209084019055865487908061299057fe5b60019003818190600052602060002001600090559055866001016000878152602001908152602001600020600090556001945050505050611b56565b6000915050611b56565b5490565b6004546041028114612a4d57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c6964206174746573746174696f6e206c656e677468000000000000604482015290519081900360640190fd5b60008085856040518083838082843760405192018290039091209450600093505050505b600454811015612bee576000612a906041838102908101908789613e7f565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920182905250939450612ad39250869150849050613103565b90508473ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1611612b6f57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f496e76616c6964207369676e6174757265206f72646572206f72206475706500604482015290519081900360640190fd5b612b788161169b565b612be357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f496e76616c6964207369676e61747572653a206e6f7420617474657374657200604482015290519081900360640190fd5b935050600101612a71565b50505050505050565b815160009060208401612c1264ffffffffff8516828461310f565b95945050505050565b612c467fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008216613170565b612cb157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601160248201527f4d616c666f726d6564206d657373616765000000000000000000000000000000604482015290519081900360640190fd5b6094612cde7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000083166131ad565b6bffffffffffffffffffffffff161015610a3257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f496e76616c6964206d6573736167653a20746f6f2073686f7274000000000000604482015290519081900360640190fd5b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316600860046131c1565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316606c60206131e2565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000083168260046131c1565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316600c60206131e2565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000083166004806131c1565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316602c60206131e2565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316604c60206131e2565b90565b60006116a87fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000008316609060046131c1565b60006116a8609480612f157fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000086166131ad565b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000861692916bffffffffffffffffffffffff910316600061338d565b6060600080612f5f846131ad565b6bffffffffffffffffffffffff1690506040519150819250612f84848360200161341d565b508181016020016040529052919050565b60009081526001919091016020526040902054151590565b600061300f826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65648152508573ffffffffffffffffffffffffffffffffffffffff166135c29092919063ffffffff16565b8051909150156118b55780806020019051602081101561302e57600080fd5b50516118b5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602a8152602001806140e3602a913960400191505060405180910390fd5b815460009082106130e1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180613ea86022913960400191505060405180910390fd5b8260000182815481106130f057fe5b9060005260206000200154905092915050565b6000611b5383836135d1565b60008061311c8484613661565b905060405181111561312c575060005b8061315a577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000915050613169565b6131658585856136d3565b9150505b9392505050565b600061317b826136e6565b64ffffffffff1664ffffffffff1415613196575060006116ab565b60006131a1836136ec565b60405110159392505050565b60181c6bffffffffffffffffffffffff1690565b60008160200360080260ff166131d88585856131e2565b901c949350505050565b600060ff82166131f457506000613169565b6131fd846131ad565b6bffffffffffffffffffffffff166132188460ff8516613661565b11156132f75761325961322a85613716565b6bffffffffffffffffffffffff16613241866131ad565b6bffffffffffffffffffffffff16858560ff1661372a565b6040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825283818151815260200191508051906020019080838360005b838110156132bc5781810151838201526020016132a4565b50505050905090810190601f1680156132e95780820380516001836020036101000a031916815260200191505b509250505060405180910390fd5b60208260ff161115613354576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603a815260200180614087603a913960400191505060405180910390fd5b60088202600061336386613716565b6bffffffffffffffffffffffff169050600061337e83613885565b91909501511695945050505050565b60008061339986613716565b6bffffffffffffffffffffffff1690506133b2866136ec565b6133c6856133c08489613661565b90613661565b11156133f5577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000009150506111e6565b6133ff8186613661565b90506134138364ffffffffff16828661310f565b9695505050505050565b6000613428836138ce565b61347d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602881526020018061410d6028913960400191505060405180910390fd5b61348683613170565b6134db576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602b815260200180614135602b913960400191505060405180910390fd5b60006134e6846131ad565b6bffffffffffffffffffffffff169050600061350185613716565b6bffffffffffffffffffffffff1690506000806040519150858211156135275760206060fd5b8386858560045afa90508061359d57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152600c60248201527f6964656e74697479204f4f470000000000000000000000000000000000000000604482015290519081900360640190fd5b6135b76135a9886136e6565b64ffffffffff1687866136d3565b979650505050505050565b60606111e684846000856138e0565b6000815160411461364357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e67746800604482015290519081900360640190fd5b60208201516040830151606084015160001a61341386828585613a8f565b81810182811015611b5657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601960248201527f4f766572666c6f7720647572696e67206164646974696f6e2e00000000000000604482015290519081900360640190fd5b606092831b9190911790911b1760181b90565b60d81c90565b60006136f7826131ad565b61370083613716565b016bffffffffffffffffffffffff169050919050565b60781c6bffffffffffffffffffffffff1690565b6060600061373786613c7d565b915050600061374586613c7d565b915050600061375386613c7d565b915050600061376186613c7d565b915050838383836040516020018080614160603591397fffffffffffff000000000000000000000000000000000000000000000000000060d087811b821660358401527f2077697468206c656e6774682030780000000000000000000000000000000000603b84015286901b16604a8201526050016021613ffd82397fffffffffffff000000000000000000000000000000000000000000000000000060d094851b811660218301527f2077697468206c656e677468203078000000000000000000000000000000000060278301529290931b9091166036830152507f2e00000000000000000000000000000000000000000000000000000000000000603c82015260408051601d818403018152603d90920190529b9a5050505050505050505050565b7f80000000000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff9091011d90565b60006138d982613d51565b1592915050565b60608247101561393b576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180613fd76026913960400191505060405180910390fd5b613944856123a6565b6139af57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015290519081900360640190fd5b6000808673ffffffffffffffffffffffffffffffffffffffff1685876040518082805190602001908083835b60208310613a1857805182527fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe090920191602091820191016139db565b6001836020036101000a03801982511681845116808217855250505050505090500191505060006040518083038185875af1925050503d8060008114613a7a576040519150601f19603f3d011682016040523d82523d6000602084013e613a7f565b606091505b50915091506135b7828286613d79565b60007f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0821115613b0a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180613fb56022913960400191505060405180910390fd5b8360ff16601b1480613b1f57508360ff16601c145b613b74576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602281526020018061401e6022913960400191505060405180910390fd5b600060018686868660405160008152602001604052604051808581526020018460ff1681526020018381526020018281526020019450505050506020604051602081039080840390855afa158015613bd0573d6000803e3d6000fd5b50506040517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0015191505073ffffffffffffffffffffffffffffffffffffffff8116612c1257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601860248201527f45434453413a20696e76616c6964207369676e61747572650000000000000000604482015290519081900360640190fd5b600080601f5b600f8160ff161115613ce55760ff600882021684901c613ca281613df9565b61ffff16841793508160ff16601014613cbd57601084901b93505b507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff01613c83565b50600f5b60ff8160ff161015613d4b5760ff600882021684901c613d0881613df9565b61ffff16831792508160ff16600014613d2357601083901b92505b507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff01613ce9565b50915091565b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000009081161490565b60608315613d88575081613169565b825115613d985782518084602001fd5b6040517f08c379a00000000000000000000000000000000000000000000000000000000081526020600482018181528451602484015284518593919283926044019190850190808383600083156132bc5781810151838201526020016132a4565b6000613e0b60048360ff16901c613e29565b60ff161760081b62ffff0016613e2082613e29565b60ff1617919050565b6040805180820190915260108082527f30313233343536373839616263646566000000000000000000000000000000006020830152600091600f84169182908110613e7057fe5b016020015160f81c9392505050565b60008085851115613e8e578182fd5b83861115613e9a578182fd5b505082019391909203915056fe456e756d657261626c655365743a20696e646578206f7574206f6620626f756e64735061757361626c653a206e65772070617573657220697320746865207a65726f2061646472657373496e697469616c697a61626c653a20696e76616c696420696e697469616c697a6174696f6e4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206e6577206f776e6572526573637561626c653a206e6577207265736375657220697320746865207a65726f20616464726573735369676e6174757265207468726573686f6c6420657863656564732061747465737465727368616e646c655265636569766546696e616c697a65644d6573736167652829206661696c656445434453413a20696e76616c6964207369676e6174757265202773272076616c7565416464726573733a20696e73756666696369656e742062616c616e636520666f722063616c6c2e20417474656d7074656420746f20696e646578206174206f666673657420307845434453413a20696e76616c6964207369676e6174757265202776272076616c7565526573637561626c653a2063616c6c6572206973206e6f7420746865207265736375657241747465737465724d616e6167657220697320746865207a65726f206164647265737354797065644d656d566965772f696e646578202d20417474656d7074656420746f20696e646578206d6f7265207468616e2033322062797465735061757361626c653a2063616c6c6572206973206e6f7420746865207061757365725361666545524332303a204552433230206f7065726174696f6e20646964206e6f74207375636365656454797065644d656d566965772f636f7079546f202d204e756c6c20706f696e74657220646572656654797065644d656d566965772f636f7079546f202d20496e76616c696420706f696e74657220646572656654797065644d656d566965772f696e646578202d204f76657272616e2074686520766965772e20536c69636520697320617420307868616e646c6552656365697665556e66696e616c697a65644d6573736167652829206661696c6564a2646970667358221220a00165ce6e6796a53230fb3366595e0ea95a7bf3ce20f2ff3464ada879d3f15764736f6c63430007060033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000001
-----Decoded View---------------
Arg [0] : _localDomain (uint32): 18
Arg [1] : _version (uint32): 1
-----Encoded View---------------
2 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000012
Arg [1] : 0000000000000000000000000000000000000000000000000000000000000001
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 34 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.