Source Code
View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Loading...
Loading
Cross-Chain Transactions
Loading...
Loading
Contract Source Code Verified (Exact Match)
Contract Name:
LockReleaseTokenPool
Compiler Version
v0.8.24+commit.e11b9ed9
Optimization Enabled:
Yes with 200 runs
Other Settings:
shanghai EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.24;
import {ILiquidityContainer} from "../../liquiditymanager/interfaces/ILiquidityContainer.sol";
import {ITypeAndVersion} from "../../shared/interfaces/ITypeAndVersion.sol";
import {Pool} from "../libraries/Pool.sol";
import {TokenPool} from "./TokenPool.sol";
import {IERC20} from "../../vendor/openzeppelin-solidity/v4.8.3/contracts/token/ERC20/IERC20.sol";
import {SafeERC20} from "../../vendor/openzeppelin-solidity/v4.8.3/contracts/token/ERC20/utils/SafeERC20.sol";
import {IERC165} from "../../vendor/openzeppelin-solidity/v5.0.2/contracts/utils/introspection/IERC165.sol";
/// @notice Token pool used for tokens on their native chain. This uses a lock and release mechanism.
/// Because of lock/unlock requiring liquidity, this pool contract also has function to add and remove
/// liquidity. This allows for proper bookkeeping for both user and liquidity provider balances.
/// @dev One token per LockReleaseTokenPool.
contract LockReleaseTokenPool is TokenPool, ILiquidityContainer, ITypeAndVersion {
using SafeERC20 for IERC20;
error InsufficientLiquidity();
error LiquidityNotAccepted();
event LiquidityTransferred(address indexed from, uint256 amount);
string public constant override typeAndVersion = "LockReleaseTokenPool 1.5.1";
/// @dev Whether or not the pool accepts liquidity.
/// External liquidity is not required when there is one canonical token deployed to a chain,
/// and CCIP is facilitating mint/burn on all the other chains, in which case the invariant
/// balanceOf(pool) on home chain >= sum(totalSupply(mint/burn "wrapped" token) on all remote chains) should always hold
bool internal immutable i_acceptLiquidity;
/// @notice The address of the rebalancer.
address internal s_rebalancer;
constructor(
IERC20 token,
uint8 localTokenDecimals,
address[] memory allowlist,
address rmnProxy,
bool acceptLiquidity,
address router
) TokenPool(token, localTokenDecimals, allowlist, rmnProxy, router) {
i_acceptLiquidity = acceptLiquidity;
}
/// @notice Locks the token in the pool
/// @dev The _validateLockOrBurn check is an essential security check
function lockOrBurn(
Pool.LockOrBurnInV1 calldata lockOrBurnIn
) external virtual override returns (Pool.LockOrBurnOutV1 memory) {
_validateLockOrBurn(lockOrBurnIn);
emit Locked(msg.sender, lockOrBurnIn.amount);
return Pool.LockOrBurnOutV1({
destTokenAddress: getRemoteToken(lockOrBurnIn.remoteChainSelector),
destPoolData: _encodeLocalDecimals()
});
}
/// @notice Release tokens from the pool to the recipient
/// @dev The _validateReleaseOrMint check is an essential security check
function releaseOrMint(
Pool.ReleaseOrMintInV1 calldata releaseOrMintIn
) external virtual override returns (Pool.ReleaseOrMintOutV1 memory) {
_validateReleaseOrMint(releaseOrMintIn);
// Calculate the local amount
uint256 localAmount =
_calculateLocalAmount(releaseOrMintIn.amount, _parseRemoteDecimals(releaseOrMintIn.sourcePoolData));
// Release to the recipient
getToken().safeTransfer(releaseOrMintIn.receiver, localAmount);
emit Released(msg.sender, releaseOrMintIn.receiver, localAmount);
return Pool.ReleaseOrMintOutV1({destinationAmount: localAmount});
}
/// @inheritdoc IERC165
function supportsInterface(
bytes4 interfaceId
) public pure virtual override returns (bool) {
return interfaceId == type(ILiquidityContainer).interfaceId || super.supportsInterface(interfaceId);
}
/// @notice Gets LiquidityManager, can be address(0) if none is configured.
/// @return The current liquidity manager.
function getRebalancer() external view returns (address) {
return s_rebalancer;
}
/// @notice Sets the LiquidityManager address.
/// @dev Only callable by the owner.
function setRebalancer(
address rebalancer
) external onlyOwner {
s_rebalancer = rebalancer;
}
/// @notice Checks if the pool can accept liquidity.
/// @return true if the pool can accept liquidity, false otherwise.
function canAcceptLiquidity() external view returns (bool) {
return i_acceptLiquidity;
}
/// @notice Adds liquidity to the pool. The tokens should be approved first.
/// @param amount The amount of liquidity to provide.
function provideLiquidity(
uint256 amount
) external {
if (!i_acceptLiquidity) revert LiquidityNotAccepted();
if (s_rebalancer != msg.sender) revert Unauthorized(msg.sender);
i_token.safeTransferFrom(msg.sender, address(this), amount);
emit LiquidityAdded(msg.sender, amount);
}
/// @notice Removed liquidity to the pool. The tokens will be sent to msg.sender.
/// @param amount The amount of liquidity to remove.
function withdrawLiquidity(
uint256 amount
) external {
if (s_rebalancer != msg.sender) revert Unauthorized(msg.sender);
if (i_token.balanceOf(address(this)) < amount) revert InsufficientLiquidity();
i_token.safeTransfer(msg.sender, amount);
emit LiquidityRemoved(msg.sender, amount);
}
/// @notice This function can be used to transfer liquidity from an older version of the pool to this pool. To do so
/// this pool will have to be set as the rebalancer in the older version of the pool. This allows it to transfer the
/// funds in the old pool to the new pool.
/// @dev When upgrading a LockRelease pool, this function can be called at the same time as the pool is changed in the
/// TokenAdminRegistry. This allows for a smooth transition of both liquidity and transactions to the new pool.
/// Alternatively, when no multicall is available, a portion of the funds can be transferred to the new pool before
/// changing which pool CCIP uses, to ensure both pools can operate. Then the pool should be changed in the
/// TokenAdminRegistry, which will activate the new pool. All new transactions will use the new pool and its
/// liquidity. Finally, the remaining liquidity can be transferred to the new pool using this function one more time.
/// @param from The address of the old pool.
/// @param amount The amount of liquidity to transfer.
function transferLiquidity(address from, uint256 amount) external onlyOwner {
LockReleaseTokenPool(from).withdrawLiquidity(amount);
emit LiquidityTransferred(from, amount);
}
}// SPDX-License-Identifier: BUSL-1.1
pragma solidity ^0.8.0;
/// @notice Interface for a liquidity container, this can be a CCIP token pool.
interface ILiquidityContainer {
event LiquidityAdded(address indexed provider, uint256 indexed amount);
event LiquidityRemoved(address indexed provider, uint256 indexed amount);
/// @notice Provide additional liquidity to the container.
/// @dev Should emit LiquidityAdded
function provideLiquidity(uint256 amount) external;
/// @notice Withdraws liquidity from the container to the msg sender
/// @dev Should emit LiquidityRemoved
function withdrawLiquidity(uint256 amount) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface ITypeAndVersion {
function typeAndVersion() external pure returns (string memory);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/// @notice This library contains various token pool functions to aid constructing the return data.
library Pool {
// The tag used to signal support for the pool v1 standard
// bytes4(keccak256("CCIP_POOL_V1"))
bytes4 public constant CCIP_POOL_V1 = 0xaff2afbf;
// The number of bytes in the return data for a pool v1 releaseOrMint call.
// This should match the size of the ReleaseOrMintOutV1 struct.
uint16 public constant CCIP_POOL_V1_RET_BYTES = 32;
// The default max number of bytes in the return data for a pool v1 lockOrBurn call.
// This data can be used to send information to the destination chain token pool. Can be overwritten
// in the TokenTransferFeeConfig.destBytesOverhead if more data is required.
uint32 public constant CCIP_LOCK_OR_BURN_V1_RET_BYTES = 32;
struct LockOrBurnInV1 {
bytes receiver; // The recipient of the tokens on the destination chain, abi encoded
uint64 remoteChainSelector; // ─╮ The chain ID of the destination chain
address originalSender; // ─────╯ The original sender of the tx on the source chain
uint256 amount; // The amount of tokens to lock or burn, denominated in the source token's decimals
address localToken; // The address on this chain of the token to lock or burn
}
struct LockOrBurnOutV1 {
// The address of the destination token, abi encoded in the case of EVM chains
// This value is UNTRUSTED as any pool owner can return whatever value they want.
bytes destTokenAddress;
// Optional pool data to be transferred to the destination chain. Be default this is capped at
// CCIP_LOCK_OR_BURN_V1_RET_BYTES bytes. If more data is required, the TokenTransferFeeConfig.destBytesOverhead
// has to be set for the specific token.
bytes destPoolData;
}
struct ReleaseOrMintInV1 {
bytes originalSender; // The original sender of the tx on the source chain
uint64 remoteChainSelector; // ─╮ The chain ID of the source chain
address receiver; // ───────────╯ The recipient of the tokens on the destination chain.
uint256 amount; // The amount of tokens to release or mint, denominated in the source token's decimals
address localToken; // The address on this chain of the token to release or mint
/// @dev WARNING: sourcePoolAddress should be checked prior to any processing of funds. Make sure it matches the
/// expected pool address for the given remoteChainSelector.
bytes sourcePoolAddress; // The address of the source pool, abi encoded in the case of EVM chains
bytes sourcePoolData; // The data received from the source pool to process the release or mint
/// @dev WARNING: offchainTokenData is untrusted data.
bytes offchainTokenData; // The offchain data to process the release or mint
}
struct ReleaseOrMintOutV1 {
// The number of tokens released or minted on the destination chain, denominated in the local token's decimals.
// This value is expected to be equal to the ReleaseOrMintInV1.amount in the case where the source and destination
// chain have the same number of decimals.
uint256 destinationAmount;
}
}// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.24;
import {IPoolV1} from "../interfaces/IPool.sol";
import {IRMN} from "../interfaces/IRMN.sol";
import {IRouter} from "../interfaces/IRouter.sol";
import {Ownable2StepMsgSender} from "../../shared/access/Ownable2StepMsgSender.sol";
import {Pool} from "../libraries/Pool.sol";
import {RateLimiter} from "../libraries/RateLimiter.sol";
import {IERC20} from "../../vendor/openzeppelin-solidity/v4.8.3/contracts/token/ERC20/IERC20.sol";
import {IERC20Metadata} from
"../../vendor/openzeppelin-solidity/v4.8.3/contracts/token/ERC20/extensions/IERC20Metadata.sol";
import {IERC165} from "../../vendor/openzeppelin-solidity/v5.0.2/contracts/utils/introspection/IERC165.sol";
import {EnumerableSet} from "../../vendor/openzeppelin-solidity/v5.0.2/contracts/utils/structs/EnumerableSet.sol";
/// @dev This pool supports different decimals on different chains but using this feature could impact the total number
/// of tokens in circulation. Since all of the tokens are locked/burned on the source, and a rounded amount is minted/released on the
/// destination, the number of tokens minted/released could be less than the number of tokens burned/locked. This is because the source
/// chain does not know about the destination token decimals. This is not a problem if the decimals are the same on both
/// chains.
///
/// Example:
/// Assume there is a token with 6 decimals on chain A and 3 decimals on chain B.
/// - 1.234567 tokens are burned on chain A.
/// - 1.234 tokens are minted on chain B.
/// When sending the 1.234 tokens back to chain A, you will receive 1.234000 tokens on chain A, effectively losing
/// 0.000567 tokens.
/// In the case of a burnMint pool on chain A, these funds are burned in the pool on chain A.
/// In the case of a lockRelease pool on chain A, these funds accumulate in the pool on chain A.
abstract contract TokenPool is IPoolV1, Ownable2StepMsgSender {
using EnumerableSet for EnumerableSet.Bytes32Set;
using EnumerableSet for EnumerableSet.AddressSet;
using EnumerableSet for EnumerableSet.UintSet;
using RateLimiter for RateLimiter.TokenBucket;
error CallerIsNotARampOnRouter(address caller);
error ZeroAddressNotAllowed();
error SenderNotAllowed(address sender);
error AllowListNotEnabled();
error NonExistentChain(uint64 remoteChainSelector);
error ChainNotAllowed(uint64 remoteChainSelector);
error CursedByRMN();
error ChainAlreadyExists(uint64 chainSelector);
error InvalidSourcePoolAddress(bytes sourcePoolAddress);
error InvalidToken(address token);
error Unauthorized(address caller);
error PoolAlreadyAdded(uint64 remoteChainSelector, bytes remotePoolAddress);
error InvalidRemotePoolForChain(uint64 remoteChainSelector, bytes remotePoolAddress);
error InvalidRemoteChainDecimals(bytes sourcePoolData);
error OverflowDetected(uint8 remoteDecimals, uint8 localDecimals, uint256 remoteAmount);
error InvalidDecimalArgs(uint8 expected, uint8 actual);
event Locked(address indexed sender, uint256 amount);
event Burned(address indexed sender, uint256 amount);
event Released(address indexed sender, address indexed recipient, uint256 amount);
event Minted(address indexed sender, address indexed recipient, uint256 amount);
event ChainAdded(
uint64 remoteChainSelector,
bytes remoteToken,
RateLimiter.Config outboundRateLimiterConfig,
RateLimiter.Config inboundRateLimiterConfig
);
event ChainConfigured(
uint64 remoteChainSelector,
RateLimiter.Config outboundRateLimiterConfig,
RateLimiter.Config inboundRateLimiterConfig
);
event ChainRemoved(uint64 remoteChainSelector);
event RemotePoolAdded(uint64 indexed remoteChainSelector, bytes remotePoolAddress);
event RemotePoolRemoved(uint64 indexed remoteChainSelector, bytes remotePoolAddress);
event AllowListAdd(address sender);
event AllowListRemove(address sender);
event RouterUpdated(address oldRouter, address newRouter);
event RateLimitAdminSet(address rateLimitAdmin);
struct ChainUpdate {
uint64 remoteChainSelector; // Remote chain selector
bytes[] remotePoolAddresses; // Address of the remote pool, ABI encoded in the case of a remote EVM chain.
bytes remoteTokenAddress; // Address of the remote token, ABI encoded in the case of a remote EVM chain.
RateLimiter.Config outboundRateLimiterConfig; // Outbound rate limited config, meaning the rate limits for all of the onRamps for the given chain
RateLimiter.Config inboundRateLimiterConfig; // Inbound rate limited config, meaning the rate limits for all of the offRamps for the given chain
}
struct RemoteChainConfig {
RateLimiter.TokenBucket outboundRateLimiterConfig; // Outbound rate limited config, meaning the rate limits for all of the onRamps for the given chain
RateLimiter.TokenBucket inboundRateLimiterConfig; // Inbound rate limited config, meaning the rate limits for all of the offRamps for the given chain
bytes remoteTokenAddress; // Address of the remote token, ABI encoded in the case of a remote EVM chain.
EnumerableSet.Bytes32Set remotePools; // Set of remote pool hashes, ABI encoded in the case of a remote EVM chain.
}
/// @dev The bridgeable token that is managed by this pool. Pools could support multiple tokens at the same time if
/// required, but this implementation only supports one token.
IERC20 internal immutable i_token;
/// @dev The number of decimals of the token managed by this pool.
uint8 internal immutable i_tokenDecimals;
/// @dev The address of the RMN proxy
address internal immutable i_rmnProxy;
/// @dev The immutable flag that indicates if the pool is access-controlled.
bool internal immutable i_allowlistEnabled;
/// @dev A set of addresses allowed to trigger lockOrBurn as original senders.
/// Only takes effect if i_allowlistEnabled is true.
/// This can be used to ensure only token-issuer specified addresses can move tokens.
EnumerableSet.AddressSet internal s_allowlist;
/// @dev The address of the router
IRouter internal s_router;
/// @dev A set of allowed chain selectors. We want the allowlist to be enumerable to
/// be able to quickly determine (without parsing logs) who can access the pool.
/// @dev The chain selectors are in uint256 format because of the EnumerableSet implementation.
EnumerableSet.UintSet internal s_remoteChainSelectors;
mapping(uint64 remoteChainSelector => RemoteChainConfig) internal s_remoteChainConfigs;
/// @notice A mapping of hashed pool addresses to their unhashed form. This is used to be able to find the actually
/// configured pools and not just their hashed versions.
mapping(bytes32 poolAddressHash => bytes poolAddress) internal s_remotePoolAddresses;
/// @notice The address of the rate limiter admin.
/// @dev Can be address(0) if none is configured.
address internal s_rateLimitAdmin;
constructor(IERC20 token, uint8 localTokenDecimals, address[] memory allowlist, address rmnProxy, address router) {
if (address(token) == address(0) || router == address(0) || rmnProxy == address(0)) revert ZeroAddressNotAllowed();
i_token = token;
i_rmnProxy = rmnProxy;
try IERC20Metadata(address(token)).decimals() returns (uint8 actualTokenDecimals) {
if (localTokenDecimals != actualTokenDecimals) {
revert InvalidDecimalArgs(localTokenDecimals, actualTokenDecimals);
}
} catch {
// The decimals function doesn't exist, which is possible since it's optional in the ERC20 spec. We skip the check and
// assume the supplied token decimals are correct.
}
i_tokenDecimals = localTokenDecimals;
s_router = IRouter(router);
// Pool can be set as permissioned or permissionless at deployment time only to save hot-path gas.
i_allowlistEnabled = allowlist.length > 0;
if (i_allowlistEnabled) {
_applyAllowListUpdates(new address[](0), allowlist);
}
}
/// @inheritdoc IPoolV1
function isSupportedToken(
address token
) public view virtual returns (bool) {
return token == address(i_token);
}
/// @notice Gets the IERC20 token that this pool can lock or burn.
/// @return token The IERC20 token representation.
function getToken() public view returns (IERC20 token) {
return i_token;
}
/// @notice Get RMN proxy address
/// @return rmnProxy Address of RMN proxy
function getRmnProxy() public view returns (address rmnProxy) {
return i_rmnProxy;
}
/// @notice Gets the pool's Router
/// @return router The pool's Router
function getRouter() public view returns (address router) {
return address(s_router);
}
/// @notice Sets the pool's Router
/// @param newRouter The new Router
function setRouter(
address newRouter
) public onlyOwner {
if (newRouter == address(0)) revert ZeroAddressNotAllowed();
address oldRouter = address(s_router);
s_router = IRouter(newRouter);
emit RouterUpdated(oldRouter, newRouter);
}
/// @notice Signals which version of the pool interface is supported
function supportsInterface(
bytes4 interfaceId
) public pure virtual override returns (bool) {
return interfaceId == Pool.CCIP_POOL_V1 || interfaceId == type(IPoolV1).interfaceId
|| interfaceId == type(IERC165).interfaceId;
}
// ================================================================
// │ Validation │
// ================================================================
/// @notice Validates the lock or burn input for correctness on
/// - token to be locked or burned
/// - RMN curse status
/// - allowlist status
/// - if the sender is a valid onRamp
/// - rate limit status
/// @param lockOrBurnIn The input to validate.
/// @dev This function should always be called before executing a lock or burn. Not doing so would allow
/// for various exploits.
function _validateLockOrBurn(
Pool.LockOrBurnInV1 calldata lockOrBurnIn
) internal {
if (!isSupportedToken(lockOrBurnIn.localToken)) revert InvalidToken(lockOrBurnIn.localToken);
if (IRMN(i_rmnProxy).isCursed(bytes16(uint128(lockOrBurnIn.remoteChainSelector)))) revert CursedByRMN();
_checkAllowList(lockOrBurnIn.originalSender);
_onlyOnRamp(lockOrBurnIn.remoteChainSelector);
_consumeOutboundRateLimit(lockOrBurnIn.remoteChainSelector, lockOrBurnIn.amount);
}
/// @notice Validates the release or mint input for correctness on
/// - token to be released or minted
/// - RMN curse status
/// - if the sender is a valid offRamp
/// - if the source pool is valid
/// - rate limit status
/// @param releaseOrMintIn The input to validate.
/// @dev This function should always be called before executing a release or mint. Not doing so would allow
/// for various exploits.
function _validateReleaseOrMint(
Pool.ReleaseOrMintInV1 calldata releaseOrMintIn
) internal {
if (!isSupportedToken(releaseOrMintIn.localToken)) revert InvalidToken(releaseOrMintIn.localToken);
if (IRMN(i_rmnProxy).isCursed(bytes16(uint128(releaseOrMintIn.remoteChainSelector)))) revert CursedByRMN();
_onlyOffRamp(releaseOrMintIn.remoteChainSelector);
// Validates that the source pool address is configured on this pool.
if (!isRemotePool(releaseOrMintIn.remoteChainSelector, releaseOrMintIn.sourcePoolAddress)) {
revert InvalidSourcePoolAddress(releaseOrMintIn.sourcePoolAddress);
}
_consumeInboundRateLimit(releaseOrMintIn.remoteChainSelector, releaseOrMintIn.amount);
}
// ================================================================
// │ Token decimals │
// ================================================================
/// @notice Gets the IERC20 token decimals on the local chain.
function getTokenDecimals() public view virtual returns (uint8 decimals) {
return i_tokenDecimals;
}
function _encodeLocalDecimals() internal view virtual returns (bytes memory) {
return abi.encode(i_tokenDecimals);
}
function _parseRemoteDecimals(
bytes memory sourcePoolData
) internal view virtual returns (uint8) {
// Fallback to the local token decimals if the source pool data is empty. This allows for backwards compatibility.
if (sourcePoolData.length == 0) {
return i_tokenDecimals;
}
if (sourcePoolData.length != 32) {
revert InvalidRemoteChainDecimals(sourcePoolData);
}
uint256 remoteDecimals = abi.decode(sourcePoolData, (uint256));
if (remoteDecimals > type(uint8).max) {
revert InvalidRemoteChainDecimals(sourcePoolData);
}
return uint8(remoteDecimals);
}
/// @notice Calculates the local amount based on the remote amount and decimals.
/// @param remoteAmount The amount on the remote chain.
/// @param remoteDecimals The decimals of the token on the remote chain.
/// @return The local amount.
/// @dev This function protects against overflows. If there is a transaction that hits the overflow check, it is
/// probably incorrect as that means the amount cannot be represented on this chain. If the local decimals have been
/// wrongly configured, the token issuer could redeploy the pool with the correct decimals and manually re-execute the
/// CCIP tx to fix the issue.
function _calculateLocalAmount(uint256 remoteAmount, uint8 remoteDecimals) internal view virtual returns (uint256) {
if (remoteDecimals == i_tokenDecimals) {
return remoteAmount;
}
if (remoteDecimals > i_tokenDecimals) {
uint8 decimalsDiff = remoteDecimals - i_tokenDecimals;
if (decimalsDiff > 77) {
// This is a safety check to prevent overflow in the next calculation.
revert OverflowDetected(remoteDecimals, i_tokenDecimals, remoteAmount);
}
// Solidity rounds down so there is no risk of minting more tokens than the remote chain sent.
return remoteAmount / (10 ** decimalsDiff);
}
// This is a safety check to prevent overflow in the next calculation.
// More than 77 would never fit in a uint256 and would cause an overflow. We also check if the resulting amount
// would overflow.
uint8 diffDecimals = i_tokenDecimals - remoteDecimals;
if (diffDecimals > 77 || remoteAmount > type(uint256).max / (10 ** diffDecimals)) {
revert OverflowDetected(remoteDecimals, i_tokenDecimals, remoteAmount);
}
return remoteAmount * (10 ** diffDecimals);
}
// ================================================================
// │ Chain permissions │
// ================================================================
/// @notice Gets the pool address on the remote chain.
/// @param remoteChainSelector Remote chain selector.
/// @dev To support non-evm chains, this value is encoded into bytes
function getRemotePools(
uint64 remoteChainSelector
) public view returns (bytes[] memory) {
bytes32[] memory remotePoolHashes = s_remoteChainConfigs[remoteChainSelector].remotePools.values();
bytes[] memory remotePools = new bytes[](remotePoolHashes.length);
for (uint256 i = 0; i < remotePoolHashes.length; ++i) {
remotePools[i] = s_remotePoolAddresses[remotePoolHashes[i]];
}
return remotePools;
}
/// @notice Checks if the pool address is configured on the remote chain.
/// @param remoteChainSelector Remote chain selector.
/// @param remotePoolAddress The address of the remote pool.
function isRemotePool(uint64 remoteChainSelector, bytes calldata remotePoolAddress) public view returns (bool) {
return s_remoteChainConfigs[remoteChainSelector].remotePools.contains(keccak256(remotePoolAddress));
}
/// @notice Gets the token address on the remote chain.
/// @param remoteChainSelector Remote chain selector.
/// @dev To support non-evm chains, this value is encoded into bytes
function getRemoteToken(
uint64 remoteChainSelector
) public view returns (bytes memory) {
return s_remoteChainConfigs[remoteChainSelector].remoteTokenAddress;
}
/// @notice Adds a remote pool for a given chain selector. This could be due to a pool being upgraded on the remote
/// chain. We don't simply want to replace the old pool as there could still be valid inflight messages from the old
/// pool. This function allows for multiple pools to be added for a single chain selector.
/// @param remoteChainSelector The remote chain selector for which the remote pool address is being added.
/// @param remotePoolAddress The address of the new remote pool.
function addRemotePool(uint64 remoteChainSelector, bytes calldata remotePoolAddress) external onlyOwner {
if (!isSupportedChain(remoteChainSelector)) revert NonExistentChain(remoteChainSelector);
_setRemotePool(remoteChainSelector, remotePoolAddress);
}
/// @notice Removes the remote pool address for a given chain selector.
/// @dev All inflight txs from the remote pool will be rejected after it is removed. To ensure no loss of funds, there
/// should be no inflight txs from the given pool.
function removeRemotePool(uint64 remoteChainSelector, bytes calldata remotePoolAddress) external onlyOwner {
if (!isSupportedChain(remoteChainSelector)) revert NonExistentChain(remoteChainSelector);
if (!s_remoteChainConfigs[remoteChainSelector].remotePools.remove(keccak256(remotePoolAddress))) {
revert InvalidRemotePoolForChain(remoteChainSelector, remotePoolAddress);
}
emit RemotePoolRemoved(remoteChainSelector, remotePoolAddress);
}
/// @inheritdoc IPoolV1
function isSupportedChain(
uint64 remoteChainSelector
) public view returns (bool) {
return s_remoteChainSelectors.contains(remoteChainSelector);
}
/// @notice Get list of allowed chains
/// @return list of chains.
function getSupportedChains() public view returns (uint64[] memory) {
uint256[] memory uint256ChainSelectors = s_remoteChainSelectors.values();
uint64[] memory chainSelectors = new uint64[](uint256ChainSelectors.length);
for (uint256 i = 0; i < uint256ChainSelectors.length; ++i) {
chainSelectors[i] = uint64(uint256ChainSelectors[i]);
}
return chainSelectors;
}
/// @notice Sets the permissions for a list of chains selectors. Actual senders for these chains
/// need to be allowed on the Router to interact with this pool.
/// @param remoteChainSelectorsToRemove A list of chain selectors to remove.
/// @param chainsToAdd A list of chains and their new permission status & rate limits. Rate limits
/// are only used when the chain is being added through `allowed` being true.
/// @dev Only callable by the owner
function applyChainUpdates(
uint64[] calldata remoteChainSelectorsToRemove,
ChainUpdate[] calldata chainsToAdd
) external virtual onlyOwner {
for (uint256 i = 0; i < remoteChainSelectorsToRemove.length; ++i) {
uint64 remoteChainSelectorToRemove = remoteChainSelectorsToRemove[i];
// If the chain doesn't exist, revert
if (!s_remoteChainSelectors.remove(remoteChainSelectorToRemove)) {
revert NonExistentChain(remoteChainSelectorToRemove);
}
// Remove all remote pool hashes for the chain
bytes32[] memory remotePools = s_remoteChainConfigs[remoteChainSelectorToRemove].remotePools.values();
for (uint256 j = 0; j < remotePools.length; ++j) {
s_remoteChainConfigs[remoteChainSelectorToRemove].remotePools.remove(remotePools[j]);
}
delete s_remoteChainConfigs[remoteChainSelectorToRemove];
emit ChainRemoved(remoteChainSelectorToRemove);
}
for (uint256 i = 0; i < chainsToAdd.length; ++i) {
ChainUpdate memory newChain = chainsToAdd[i];
RateLimiter._validateTokenBucketConfig(newChain.outboundRateLimiterConfig, false);
RateLimiter._validateTokenBucketConfig(newChain.inboundRateLimiterConfig, false);
if (newChain.remoteTokenAddress.length == 0) {
revert ZeroAddressNotAllowed();
}
// If the chain already exists, revert
if (!s_remoteChainSelectors.add(newChain.remoteChainSelector)) {
revert ChainAlreadyExists(newChain.remoteChainSelector);
}
RemoteChainConfig storage remoteChainConfig = s_remoteChainConfigs[newChain.remoteChainSelector];
remoteChainConfig.outboundRateLimiterConfig = RateLimiter.TokenBucket({
rate: newChain.outboundRateLimiterConfig.rate,
capacity: newChain.outboundRateLimiterConfig.capacity,
tokens: newChain.outboundRateLimiterConfig.capacity,
lastUpdated: uint32(block.timestamp),
isEnabled: newChain.outboundRateLimiterConfig.isEnabled
});
remoteChainConfig.inboundRateLimiterConfig = RateLimiter.TokenBucket({
rate: newChain.inboundRateLimiterConfig.rate,
capacity: newChain.inboundRateLimiterConfig.capacity,
tokens: newChain.inboundRateLimiterConfig.capacity,
lastUpdated: uint32(block.timestamp),
isEnabled: newChain.inboundRateLimiterConfig.isEnabled
});
remoteChainConfig.remoteTokenAddress = newChain.remoteTokenAddress;
for (uint256 j = 0; j < newChain.remotePoolAddresses.length; ++j) {
_setRemotePool(newChain.remoteChainSelector, newChain.remotePoolAddresses[j]);
}
emit ChainAdded(
newChain.remoteChainSelector,
newChain.remoteTokenAddress,
newChain.outboundRateLimiterConfig,
newChain.inboundRateLimiterConfig
);
}
}
/// @notice Adds a pool address to the allowed remote token pools for a particular chain.
/// @param remoteChainSelector The remote chain selector for which the remote pool address is being added.
/// @param remotePoolAddress The address of the new remote pool.
function _setRemotePool(uint64 remoteChainSelector, bytes memory remotePoolAddress) internal {
if (remotePoolAddress.length == 0) {
revert ZeroAddressNotAllowed();
}
bytes32 poolHash = keccak256(remotePoolAddress);
// Check if the pool already exists.
if (!s_remoteChainConfigs[remoteChainSelector].remotePools.add(poolHash)) {
revert PoolAlreadyAdded(remoteChainSelector, remotePoolAddress);
}
// Add the pool to the mapping to be able to un-hash it later.
s_remotePoolAddresses[poolHash] = remotePoolAddress;
emit RemotePoolAdded(remoteChainSelector, remotePoolAddress);
}
// ================================================================
// │ Rate limiting │
// ================================================================
/// @dev The inbound rate limits should be slightly higher than the outbound rate limits. This is because many chains
/// finalize blocks in batches. CCIP also commits messages in batches: the commit plugin bundles multiple messages in
/// a single merkle root.
/// Imagine the following scenario.
/// - Chain A has an inbound and outbound rate limit of 100 tokens capacity and 1 token per second refill rate.
/// - Chain B has an inbound and outbound rate limit of 100 tokens capacity and 1 token per second refill rate.
///
/// At time 0:
/// - Chain A sends 100 tokens to Chain B.
/// At time 5:
/// - Chain A sends 5 tokens to Chain B.
/// At time 6:
/// The epoch that contains blocks [0-5] is finalized.
/// Both transactions will be included in the same merkle root and become executable at the same time. This means
/// the token pool on chain B requires a capacity of 105 to successfully execute both messages at the same time.
/// The exact additional capacity required depends on the refill rate and the size of the source chain epochs and the
/// CCIP round time. For simplicity, a 5-10% buffer should be sufficient in most cases.
/// @notice Sets the rate limiter admin address.
/// @dev Only callable by the owner.
/// @param rateLimitAdmin The new rate limiter admin address.
function setRateLimitAdmin(
address rateLimitAdmin
) external onlyOwner {
s_rateLimitAdmin = rateLimitAdmin;
emit RateLimitAdminSet(rateLimitAdmin);
}
/// @notice Gets the rate limiter admin address.
function getRateLimitAdmin() external view returns (address) {
return s_rateLimitAdmin;
}
/// @notice Consumes outbound rate limiting capacity in this pool
function _consumeOutboundRateLimit(uint64 remoteChainSelector, uint256 amount) internal {
s_remoteChainConfigs[remoteChainSelector].outboundRateLimiterConfig._consume(amount, address(i_token));
}
/// @notice Consumes inbound rate limiting capacity in this pool
function _consumeInboundRateLimit(uint64 remoteChainSelector, uint256 amount) internal {
s_remoteChainConfigs[remoteChainSelector].inboundRateLimiterConfig._consume(amount, address(i_token));
}
/// @notice Gets the token bucket with its values for the block it was requested at.
/// @return The token bucket.
function getCurrentOutboundRateLimiterState(
uint64 remoteChainSelector
) external view returns (RateLimiter.TokenBucket memory) {
return s_remoteChainConfigs[remoteChainSelector].outboundRateLimiterConfig._currentTokenBucketState();
}
/// @notice Gets the token bucket with its values for the block it was requested at.
/// @return The token bucket.
function getCurrentInboundRateLimiterState(
uint64 remoteChainSelector
) external view returns (RateLimiter.TokenBucket memory) {
return s_remoteChainConfigs[remoteChainSelector].inboundRateLimiterConfig._currentTokenBucketState();
}
/// @notice Sets the chain rate limiter config.
/// @param remoteChainSelector The remote chain selector for which the rate limits apply.
/// @param outboundConfig The new outbound rate limiter config, meaning the onRamp rate limits for the given chain.
/// @param inboundConfig The new inbound rate limiter config, meaning the offRamp rate limits for the given chain.
function setChainRateLimiterConfig(
uint64 remoteChainSelector,
RateLimiter.Config memory outboundConfig,
RateLimiter.Config memory inboundConfig
) external {
if (msg.sender != s_rateLimitAdmin && msg.sender != owner()) revert Unauthorized(msg.sender);
_setRateLimitConfig(remoteChainSelector, outboundConfig, inboundConfig);
}
function _setRateLimitConfig(
uint64 remoteChainSelector,
RateLimiter.Config memory outboundConfig,
RateLimiter.Config memory inboundConfig
) internal {
if (!isSupportedChain(remoteChainSelector)) revert NonExistentChain(remoteChainSelector);
RateLimiter._validateTokenBucketConfig(outboundConfig, false);
s_remoteChainConfigs[remoteChainSelector].outboundRateLimiterConfig._setTokenBucketConfig(outboundConfig);
RateLimiter._validateTokenBucketConfig(inboundConfig, false);
s_remoteChainConfigs[remoteChainSelector].inboundRateLimiterConfig._setTokenBucketConfig(inboundConfig);
emit ChainConfigured(remoteChainSelector, outboundConfig, inboundConfig);
}
// ================================================================
// │ Access │
// ================================================================
/// @notice Checks whether remote chain selector is configured on this contract, and if the msg.sender
/// is a permissioned onRamp for the given chain on the Router.
function _onlyOnRamp(
uint64 remoteChainSelector
) internal view {
if (!isSupportedChain(remoteChainSelector)) revert ChainNotAllowed(remoteChainSelector);
if (!(msg.sender == s_router.getOnRamp(remoteChainSelector))) revert CallerIsNotARampOnRouter(msg.sender);
}
/// @notice Checks whether remote chain selector is configured on this contract, and if the msg.sender
/// is a permissioned offRamp for the given chain on the Router.
function _onlyOffRamp(
uint64 remoteChainSelector
) internal view {
if (!isSupportedChain(remoteChainSelector)) revert ChainNotAllowed(remoteChainSelector);
if (!s_router.isOffRamp(remoteChainSelector, msg.sender)) revert CallerIsNotARampOnRouter(msg.sender);
}
// ================================================================
// │ Allowlist │
// ================================================================
function _checkAllowList(
address sender
) internal view {
if (i_allowlistEnabled) {
if (!s_allowlist.contains(sender)) {
revert SenderNotAllowed(sender);
}
}
}
/// @notice Gets whether the allowlist functionality is enabled.
/// @return true is enabled, false if not.
function getAllowListEnabled() external view returns (bool) {
return i_allowlistEnabled;
}
/// @notice Gets the allowed addresses.
/// @return The allowed addresses.
function getAllowList() external view returns (address[] memory) {
return s_allowlist.values();
}
/// @notice Apply updates to the allow list.
/// @param removes The addresses to be removed.
/// @param adds The addresses to be added.
function applyAllowListUpdates(address[] calldata removes, address[] calldata adds) external onlyOwner {
_applyAllowListUpdates(removes, adds);
}
/// @notice Internal version of applyAllowListUpdates to allow for reuse in the constructor.
function _applyAllowListUpdates(address[] memory removes, address[] memory adds) internal {
if (!i_allowlistEnabled) revert AllowListNotEnabled();
for (uint256 i = 0; i < removes.length; ++i) {
address toRemove = removes[i];
if (s_allowlist.remove(toRemove)) {
emit AllowListRemove(toRemove);
}
}
for (uint256 i = 0; i < adds.length; ++i) {
address toAdd = adds[i];
if (toAdd == address(0)) {
continue;
}
if (s_allowlist.add(toAdd)) {
emit AllowListAdd(toAdd);
}
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 amount) external returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/utils/SafeERC20.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
import "../extensions/draft-IERC20Permit.sol";
import "../../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using Address for address;
function safeTransfer(IERC20 token, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(IERC20 token, address spender, uint256 value) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 newAllowance = token.allowance(address(this), spender) + value;
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
uint256 newAllowance = oldAllowance - value;
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
}
function safePermit(
IERC20Permit token,
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) internal {
uint256 nonceBefore = token.nonces(owner);
token.permit(owner, spender, value, deadline, v, r, s);
uint256 nonceAfter = token.nonces(owner);
require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
if (returndata.length > 0) {
// Return data is optional
require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import {Pool} from "../libraries/Pool.sol";
import {IERC165} from "../../vendor/openzeppelin-solidity/v5.0.2/contracts/utils/introspection/IERC165.sol";
/// @notice Shared public interface for multiple V1 pool types.
/// Each pool type handles a different child token model (lock/unlock, mint/burn.)
interface IPoolV1 is IERC165 {
/// @notice Lock tokens into the pool or burn the tokens.
/// @param lockOrBurnIn Encoded data fields for the processing of tokens on the source chain.
/// @return lockOrBurnOut Encoded data fields for the processing of tokens on the destination chain.
function lockOrBurn(
Pool.LockOrBurnInV1 calldata lockOrBurnIn
) external returns (Pool.LockOrBurnOutV1 memory lockOrBurnOut);
/// @notice Releases or mints tokens to the receiver address.
/// @param releaseOrMintIn All data required to release or mint tokens.
/// @return releaseOrMintOut The amount of tokens released or minted on the local chain, denominated
/// in the local token's decimals.
/// @dev The offramp asserts that the balanceOf of the receiver has been incremented by exactly the number
/// of tokens that is returned in ReleaseOrMintOutV1.destinationAmount. If the amounts do not match, the tx reverts.
function releaseOrMint(
Pool.ReleaseOrMintInV1 calldata releaseOrMintIn
) external returns (Pool.ReleaseOrMintOutV1 memory);
/// @notice Checks whether a remote chain is supported in the token pool.
/// @param remoteChainSelector The selector of the remote chain.
/// @return true if the given chain is a permissioned remote chain.
function isSupportedChain(
uint64 remoteChainSelector
) external view returns (bool);
/// @notice Returns if the token pool supports the given token.
/// @param token The address of the token.
/// @return true if the token is supported by the pool.
function isSupportedToken(
address token
) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/// @notice This interface contains the only RMN-related functions that might be used on-chain by other CCIP contracts.
interface IRMN {
/// @notice A Merkle root tagged with the address of the commit store contract it is destined for.
struct TaggedRoot {
address commitStore;
bytes32 root;
}
/// @notice Callers MUST NOT cache the return value as a blessed tagged root could become unblessed.
function isBlessed(
TaggedRoot calldata taggedRoot
) external view returns (bool);
/// @notice Iff there is an active global or legacy curse, this function returns true.
function isCursed() external view returns (bool);
/// @notice Iff there is an active global curse, or an active curse for `subject`, this function returns true.
/// @param subject To check whether a particular chain is cursed, set to bytes16(uint128(chainSelector)).
function isCursed(
bytes16 subject
) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import {Client} from "../libraries/Client.sol";
interface IRouter {
error OnlyOffRamp();
/// @notice Route the message to its intended receiver contract.
/// @param message Client.Any2EVMMessage struct.
/// @param gasForCallExactCheck of params for exec
/// @param gasLimit set of params for exec
/// @param receiver set of params for exec
/// @dev if the receiver is a contracts that signals support for CCIP execution through EIP-165.
/// the contract is called. If not, only tokens are transferred.
/// @return success A boolean value indicating whether the ccip message was received without errors.
/// @return retBytes A bytes array containing return data form CCIP receiver.
/// @return gasUsed the gas used by the external customer call. Does not include any overhead.
function routeMessage(
Client.Any2EVMMessage calldata message,
uint16 gasForCallExactCheck,
uint256 gasLimit,
address receiver
) external returns (bool success, bytes memory retBytes, uint256 gasUsed);
/// @notice Returns the configured onramp for a specific destination chain.
/// @param destChainSelector The destination chain Id to get the onRamp for.
/// @return onRampAddress The address of the onRamp.
function getOnRamp(
uint64 destChainSelector
) external view returns (address onRampAddress);
/// @notice Return true if the given offRamp is a configured offRamp for the given source chain.
/// @param sourceChainSelector The source chain selector to check.
/// @param offRamp The address of the offRamp to check.
function isOffRamp(uint64 sourceChainSelector, address offRamp) external view returns (bool isOffRamp);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import {Ownable2Step} from "./Ownable2Step.sol";
/// @notice Sets the msg.sender to be the owner of the contract and does not set a pending owner.
contract Ownable2StepMsgSender is Ownable2Step {
constructor() Ownable2Step(msg.sender, address(0)) {}
}// SPDX-License-Identifier: BUSL-1.1
pragma solidity ^0.8.4;
/// @notice Implements Token Bucket rate limiting.
/// @dev uint128 is safe for rate limiter state.
/// For USD value rate limiting, it can adequately store USD value in 18 decimals.
/// For ERC20 token amount rate limiting, all tokens that will be listed will have at most
/// a supply of uint128.max tokens, and it will therefore not overflow the bucket.
/// In exceptional scenarios where tokens consumed may be larger than uint128,
/// e.g. compromised issuer, an enabled RateLimiter will check and revert.
library RateLimiter {
error BucketOverfilled();
error OnlyCallableByAdminOrOwner();
error TokenMaxCapacityExceeded(uint256 capacity, uint256 requested, address tokenAddress);
error TokenRateLimitReached(uint256 minWaitInSeconds, uint256 available, address tokenAddress);
error AggregateValueMaxCapacityExceeded(uint256 capacity, uint256 requested);
error AggregateValueRateLimitReached(uint256 minWaitInSeconds, uint256 available);
error InvalidRateLimitRate(Config rateLimiterConfig);
error DisabledNonZeroRateLimit(Config config);
error RateLimitMustBeDisabled();
event TokensConsumed(uint256 tokens);
event ConfigChanged(Config config);
struct TokenBucket {
uint128 tokens; // ──────╮ Current number of tokens that are in the bucket.
uint32 lastUpdated; // │ Timestamp in seconds of the last token refill, good for 100+ years.
bool isEnabled; // ──────╯ Indication whether the rate limiting is enabled or not
uint128 capacity; // ────╮ Maximum number of tokens that can be in the bucket.
uint128 rate; // ────────╯ Number of tokens per second that the bucket is refilled.
}
struct Config {
bool isEnabled; // Indication whether the rate limiting should be enabled
uint128 capacity; // ────╮ Specifies the capacity of the rate limiter
uint128 rate; // ───────╯ Specifies the rate of the rate limiter
}
/// @notice _consume removes the given tokens from the pool, lowering the
/// rate tokens allowed to be consumed for subsequent calls.
/// @param requestTokens The total tokens to be consumed from the bucket.
/// @param tokenAddress The token to consume capacity for, use 0x0 to indicate aggregate value capacity.
/// @dev Reverts when requestTokens exceeds bucket capacity or available tokens in the bucket
/// @dev emits removal of requestTokens if requestTokens is > 0
function _consume(TokenBucket storage s_bucket, uint256 requestTokens, address tokenAddress) internal {
// If there is no value to remove or rate limiting is turned off, skip this step to reduce gas usage
if (!s_bucket.isEnabled || requestTokens == 0) {
return;
}
uint256 tokens = s_bucket.tokens;
uint256 capacity = s_bucket.capacity;
uint256 timeDiff = block.timestamp - s_bucket.lastUpdated;
if (timeDiff != 0) {
if (tokens > capacity) revert BucketOverfilled();
// Refill tokens when arriving at a new block time
tokens = _calculateRefill(capacity, tokens, timeDiff, s_bucket.rate);
s_bucket.lastUpdated = uint32(block.timestamp);
}
if (capacity < requestTokens) {
// Token address 0 indicates consuming aggregate value rate limit capacity.
if (tokenAddress == address(0)) revert AggregateValueMaxCapacityExceeded(capacity, requestTokens);
revert TokenMaxCapacityExceeded(capacity, requestTokens, tokenAddress);
}
if (tokens < requestTokens) {
uint256 rate = s_bucket.rate;
// Wait required until the bucket is refilled enough to accept this value, round up to next higher second
// Consume is not guaranteed to succeed after wait time passes if there is competing traffic.
// This acts as a lower bound of wait time.
uint256 minWaitInSeconds = ((requestTokens - tokens) + (rate - 1)) / rate;
if (tokenAddress == address(0)) revert AggregateValueRateLimitReached(minWaitInSeconds, tokens);
revert TokenRateLimitReached(minWaitInSeconds, tokens, tokenAddress);
}
tokens -= requestTokens;
// Downcast is safe here, as tokens is not larger than capacity
s_bucket.tokens = uint128(tokens);
emit TokensConsumed(requestTokens);
}
/// @notice Gets the token bucket with its values for the block it was requested at.
/// @return The token bucket.
function _currentTokenBucketState(
TokenBucket memory bucket
) internal view returns (TokenBucket memory) {
// We update the bucket to reflect the status at the exact time of the
// call. This means we might need to refill a part of the bucket based
// on the time that has passed since the last update.
bucket.tokens =
uint128(_calculateRefill(bucket.capacity, bucket.tokens, block.timestamp - bucket.lastUpdated, bucket.rate));
bucket.lastUpdated = uint32(block.timestamp);
return bucket;
}
/// @notice Sets the rate limited config.
/// @param s_bucket The token bucket
/// @param config The new config
function _setTokenBucketConfig(TokenBucket storage s_bucket, Config memory config) internal {
// First update the bucket to make sure the proper rate is used for all the time
// up until the config change.
uint256 timeDiff = block.timestamp - s_bucket.lastUpdated;
if (timeDiff != 0) {
s_bucket.tokens = uint128(_calculateRefill(s_bucket.capacity, s_bucket.tokens, timeDiff, s_bucket.rate));
s_bucket.lastUpdated = uint32(block.timestamp);
}
s_bucket.tokens = uint128(_min(config.capacity, s_bucket.tokens));
s_bucket.isEnabled = config.isEnabled;
s_bucket.capacity = config.capacity;
s_bucket.rate = config.rate;
emit ConfigChanged(config);
}
/// @notice Validates the token bucket config
function _validateTokenBucketConfig(Config memory config, bool mustBeDisabled) internal pure {
if (config.isEnabled) {
if (config.rate >= config.capacity || config.rate == 0) {
revert InvalidRateLimitRate(config);
}
if (mustBeDisabled) {
revert RateLimitMustBeDisabled();
}
} else {
if (config.rate != 0 || config.capacity != 0) {
revert DisabledNonZeroRateLimit(config);
}
}
}
/// @notice Calculate refilled tokens
/// @param capacity bucket capacity
/// @param tokens current bucket tokens
/// @param timeDiff block time difference since last refill
/// @param rate bucket refill rate
/// @return the value of tokens after refill
function _calculateRefill(
uint256 capacity,
uint256 tokens,
uint256 timeDiff,
uint256 rate
) private pure returns (uint256) {
return _min(capacity, tokens + timeDiff * rate);
}
/// @notice Return the smallest of two integers
/// @param a first int
/// @param b second int
/// @return smallest
function _min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*
* _Available since v4.1._
*/
interface IERC20Metadata is IERC20 {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/structs/EnumerableSet.sol)
// This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.
pragma solidity ^0.8.20;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```solidity
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*
* [WARNING]
* ====
* Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
* unusable.
* See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
*
* In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
* array of EnumerableSet.
* ====
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position is the index of the value in the `values` array plus 1.
// Position 0 is used to mean a value is not in the set.
mapping(bytes32 value => uint256) _positions;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._positions[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We cache the value's position to prevent multiple reads from the same storage slot
uint256 position = set._positions[value];
if (position != 0) {
// Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 valueIndex = position - 1;
uint256 lastIndex = set._values.length - 1;
if (valueIndex != lastIndex) {
bytes32 lastValue = set._values[lastIndex];
// Move the lastValue to the index where the value to delete is
set._values[valueIndex] = lastValue;
// Update the tracked position of the lastValue (that was just moved)
set._positions[lastValue] = position;
}
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the tracked position for the deleted slot
delete set._positions[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._positions[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
return set._values[index];
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function _values(Set storage set) private view returns (bytes32[] memory) {
return set._values;
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
bytes32[] memory store = _values(set._inner);
bytes32[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(AddressSet storage set) internal view returns (address[] memory) {
bytes32[] memory store = _values(set._inner);
address[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(UintSet storage set) internal view returns (uint256[] memory) {
bytes32[] memory store = _values(set._inner);
uint256[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
* https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
*
* Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
* presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
* need to send a transaction, and thus is not required to hold Ether at all.
*/
interface IERC20Permit {
/**
* @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
* given ``owner``'s signed approval.
*
* IMPORTANT: The same issues {IERC20-approve} has related to transaction
* ordering also apply here.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `deadline` must be a timestamp in the future.
* - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
* over the EIP712-formatted function arguments.
* - the signature must use ``owner``'s current nonce (see {nonces}).
*
* For more information on the signature format, see the
* https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
* section].
*/
function permit(
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) external;
/**
* @dev Returns the current nonce for `owner`. This value must be
* included whenever a signature is generated for {permit}.
*
* Every successful call to {permit} increases ``owner``'s nonce by one. This
* prevents a signature from being used multiple times.
*/
function nonces(address owner) external view returns (uint256);
/**
* @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
*/
// solhint-disable-next-line func-name-mixedcase
function DOMAIN_SEPARATOR() external view returns (bytes32);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://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");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
// End consumer library.
library Client {
/// @dev RMN depends on this struct, if changing, please notify the RMN maintainers.
struct EVMTokenAmount {
address token; // token address on the local chain.
uint256 amount; // Amount of tokens.
}
struct Any2EVMMessage {
bytes32 messageId; // MessageId corresponding to ccipSend on source.
uint64 sourceChainSelector; // Source chain selector.
bytes sender; // abi.decode(sender) if coming from an EVM chain.
bytes data; // payload sent in original message.
EVMTokenAmount[] destTokenAmounts; // Tokens and their amounts in their destination chain representation.
}
// If extraArgs is empty bytes, the default is 200k gas limit.
struct EVM2AnyMessage {
bytes receiver; // abi.encode(receiver address) for dest EVM chains
bytes data; // Data payload
EVMTokenAmount[] tokenAmounts; // Token transfers
address feeToken; // Address of feeToken. address(0) means you will send msg.value.
bytes extraArgs; // Populate this with _argsToBytes(EVMExtraArgsV2)
}
// bytes4(keccak256("CCIP EVMExtraArgsV1"));
bytes4 public constant EVM_EXTRA_ARGS_V1_TAG = 0x97a657c9;
struct EVMExtraArgsV1 {
uint256 gasLimit;
}
function _argsToBytes(
EVMExtraArgsV1 memory extraArgs
) internal pure returns (bytes memory bts) {
return abi.encodeWithSelector(EVM_EXTRA_ARGS_V1_TAG, extraArgs);
}
// bytes4(keccak256("CCIP EVMExtraArgsV2"));
bytes4 public constant EVM_EXTRA_ARGS_V2_TAG = 0x181dcf10;
/// @param gasLimit: gas limit for the callback on the destination chain.
/// @param allowOutOfOrderExecution: if true, it indicates that the message can be executed in any order relative to other messages from the same sender.
/// This value's default varies by chain. On some chains, a particular value is enforced, meaning if the expected value
/// is not set, the message request will revert.
struct EVMExtraArgsV2 {
uint256 gasLimit;
bool allowOutOfOrderExecution;
}
function _argsToBytes(
EVMExtraArgsV2 memory extraArgs
) internal pure returns (bytes memory bts) {
return abi.encodeWithSelector(EVM_EXTRA_ARGS_V2_TAG, extraArgs);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import {IOwnable} from "../interfaces/IOwnable.sol";
/// @notice A minimal contract that implements 2-step ownership transfer and nothing more. It's made to be minimal
/// to reduce the impact of the bytecode size on any contract that inherits from it.
contract Ownable2Step is IOwnable {
/// @notice The pending owner is the address to which ownership may be transferred.
address private s_pendingOwner;
/// @notice The owner is the current owner of the contract.
/// @dev The owner is the second storage variable so any implementing contract could pack other state with it
/// instead of the much less used s_pendingOwner.
address private s_owner;
error OwnerCannotBeZero();
error MustBeProposedOwner();
error CannotTransferToSelf();
error OnlyCallableByOwner();
event OwnershipTransferRequested(address indexed from, address indexed to);
event OwnershipTransferred(address indexed from, address indexed to);
constructor(address newOwner, address pendingOwner) {
if (newOwner == address(0)) {
revert OwnerCannotBeZero();
}
s_owner = newOwner;
if (pendingOwner != address(0)) {
_transferOwnership(pendingOwner);
}
}
/// @notice Get the current owner
function owner() public view override returns (address) {
return s_owner;
}
/// @notice Allows an owner to begin transferring ownership to a new address. The new owner needs to call
/// `acceptOwnership` to accept the transfer before any permissions are changed.
/// @param to The address to which ownership will be transferred.
function transferOwnership(address to) public override onlyOwner {
_transferOwnership(to);
}
/// @notice validate, transfer ownership, and emit relevant events
/// @param to The address to which ownership will be transferred.
function _transferOwnership(address to) private {
if (to == msg.sender) {
revert CannotTransferToSelf();
}
s_pendingOwner = to;
emit OwnershipTransferRequested(s_owner, to);
}
/// @notice Allows an ownership transfer to be completed by the recipient.
function acceptOwnership() external override {
if (msg.sender != s_pendingOwner) {
revert MustBeProposedOwner();
}
address oldOwner = s_owner;
s_owner = msg.sender;
s_pendingOwner = address(0);
emit OwnershipTransferred(oldOwner, msg.sender);
}
/// @notice validate access
function _validateOwnership() internal view {
if (msg.sender != s_owner) {
revert OnlyCallableByOwner();
}
}
/// @notice Reverts if called by anyone other than the contract owner.
modifier onlyOwner() {
_validateOwnership();
_;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface IOwnable {
function owner() external returns (address);
function transferOwnership(address recipient) external;
function acceptOwnership() external;
}{
"remappings": [
"ds-test/=lib/forge-std/lib/ds-test/src/",
"forge-std/=lib/forge-std/src/",
"openzeppelin-contracts/=lib/openzeppelin-contracts/contracts/",
"openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/",
"utils/=lib/utils/",
"@openzeppelin/=lib/openzeppelin-contracts/",
"solidity-stringutils/=lib/openzeppelin-foundry-upgrades/lib/solidity-stringutils/",
"openzeppelin-foundry-upgrades/=lib/openzeppelin-foundry-upgrades/src/",
"@chainlink/contracts-ccip/=lib/ccip/contracts/",
"src/=src/"
],
"optimizer": {
"enabled": true,
"runs": 200
},
"metadata": {
"useLiteralContent": false,
"bytecodeHash": "ipfs",
"appendCBOR": true
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"evmVersion": "shanghai",
"viaIR": false,
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"contract IERC20","name":"token","type":"address"},{"internalType":"uint8","name":"localTokenDecimals","type":"uint8"},{"internalType":"address[]","name":"allowlist","type":"address[]"},{"internalType":"address","name":"rmnProxy","type":"address"},{"internalType":"bool","name":"acceptLiquidity","type":"bool"},{"internalType":"address","name":"router","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"uint256","name":"capacity","type":"uint256"},{"internalType":"uint256","name":"requested","type":"uint256"}],"name":"AggregateValueMaxCapacityExceeded","type":"error"},{"inputs":[{"internalType":"uint256","name":"minWaitInSeconds","type":"uint256"},{"internalType":"uint256","name":"available","type":"uint256"}],"name":"AggregateValueRateLimitReached","type":"error"},{"inputs":[],"name":"AllowListNotEnabled","type":"error"},{"inputs":[],"name":"BucketOverfilled","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"CallerIsNotARampOnRouter","type":"error"},{"inputs":[],"name":"CannotTransferToSelf","type":"error"},{"inputs":[{"internalType":"uint64","name":"chainSelector","type":"uint64"}],"name":"ChainAlreadyExists","type":"error"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"ChainNotAllowed","type":"error"},{"inputs":[],"name":"CursedByRMN","type":"error"},{"inputs":[{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.Config","name":"config","type":"tuple"}],"name":"DisabledNonZeroRateLimit","type":"error"},{"inputs":[],"name":"InsufficientLiquidity","type":"error"},{"inputs":[{"internalType":"uint8","name":"expected","type":"uint8"},{"internalType":"uint8","name":"actual","type":"uint8"}],"name":"InvalidDecimalArgs","type":"error"},{"inputs":[{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.Config","name":"rateLimiterConfig","type":"tuple"}],"name":"InvalidRateLimitRate","type":"error"},{"inputs":[{"internalType":"bytes","name":"sourcePoolData","type":"bytes"}],"name":"InvalidRemoteChainDecimals","type":"error"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"InvalidRemotePoolForChain","type":"error"},{"inputs":[{"internalType":"bytes","name":"sourcePoolAddress","type":"bytes"}],"name":"InvalidSourcePoolAddress","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"InvalidToken","type":"error"},{"inputs":[],"name":"LiquidityNotAccepted","type":"error"},{"inputs":[],"name":"MustBeProposedOwner","type":"error"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"NonExistentChain","type":"error"},{"inputs":[],"name":"OnlyCallableByOwner","type":"error"},{"inputs":[{"internalType":"uint8","name":"remoteDecimals","type":"uint8"},{"internalType":"uint8","name":"localDecimals","type":"uint8"},{"internalType":"uint256","name":"remoteAmount","type":"uint256"}],"name":"OverflowDetected","type":"error"},{"inputs":[],"name":"OwnerCannotBeZero","type":"error"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"PoolAlreadyAdded","type":"error"},{"inputs":[],"name":"RateLimitMustBeDisabled","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"SenderNotAllowed","type":"error"},{"inputs":[{"internalType":"uint256","name":"capacity","type":"uint256"},{"internalType":"uint256","name":"requested","type":"uint256"},{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"TokenMaxCapacityExceeded","type":"error"},{"inputs":[{"internalType":"uint256","name":"minWaitInSeconds","type":"uint256"},{"internalType":"uint256","name":"available","type":"uint256"},{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"TokenRateLimitReached","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"Unauthorized","type":"error"},{"inputs":[],"name":"ZeroAddressNotAllowed","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"sender","type":"address"}],"name":"AllowListAdd","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"sender","type":"address"}],"name":"AllowListRemove","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Burned","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"indexed":false,"internalType":"bytes","name":"remoteToken","type":"bytes"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"indexed":false,"internalType":"struct RateLimiter.Config","name":"outboundRateLimiterConfig","type":"tuple"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"indexed":false,"internalType":"struct RateLimiter.Config","name":"inboundRateLimiterConfig","type":"tuple"}],"name":"ChainAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"indexed":false,"internalType":"struct RateLimiter.Config","name":"outboundRateLimiterConfig","type":"tuple"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"indexed":false,"internalType":"struct RateLimiter.Config","name":"inboundRateLimiterConfig","type":"tuple"}],"name":"ChainConfigured","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"ChainRemoved","type":"event"},{"anonymous":false,"inputs":[{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"indexed":false,"internalType":"struct RateLimiter.Config","name":"config","type":"tuple"}],"name":"ConfigChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"provider","type":"address"},{"indexed":true,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"LiquidityAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"provider","type":"address"},{"indexed":true,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"LiquidityRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"LiquidityTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Locked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Minted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"OwnershipTransferRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"rateLimitAdmin","type":"address"}],"name":"RateLimitAdminSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Released","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"indexed":false,"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"RemotePoolAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"indexed":false,"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"RemotePoolRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldRouter","type":"address"},{"indexed":false,"internalType":"address","name":"newRouter","type":"address"}],"name":"RouterUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"tokens","type":"uint256"}],"name":"TokensConsumed","type":"event"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"addRemotePool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"removes","type":"address[]"},{"internalType":"address[]","name":"adds","type":"address[]"}],"name":"applyAllowListUpdates","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint64[]","name":"remoteChainSelectorsToRemove","type":"uint64[]"},{"components":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"bytes[]","name":"remotePoolAddresses","type":"bytes[]"},{"internalType":"bytes","name":"remoteTokenAddress","type":"bytes"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.Config","name":"outboundRateLimiterConfig","type":"tuple"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.Config","name":"inboundRateLimiterConfig","type":"tuple"}],"internalType":"struct TokenPool.ChainUpdate[]","name":"chainsToAdd","type":"tuple[]"}],"name":"applyChainUpdates","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"canAcceptLiquidity","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getAllowList","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getAllowListEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"getCurrentInboundRateLimiterState","outputs":[{"components":[{"internalType":"uint128","name":"tokens","type":"uint128"},{"internalType":"uint32","name":"lastUpdated","type":"uint32"},{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.TokenBucket","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"getCurrentOutboundRateLimiterState","outputs":[{"components":[{"internalType":"uint128","name":"tokens","type":"uint128"},{"internalType":"uint32","name":"lastUpdated","type":"uint32"},{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.TokenBucket","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getRateLimitAdmin","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getRebalancer","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"getRemotePools","outputs":[{"internalType":"bytes[]","name":"","type":"bytes[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"getRemoteToken","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getRmnProxy","outputs":[{"internalType":"address","name":"rmnProxy","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getRouter","outputs":[{"internalType":"address","name":"router","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getSupportedChains","outputs":[{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getToken","outputs":[{"internalType":"contract IERC20","name":"token","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTokenDecimals","outputs":[{"internalType":"uint8","name":"decimals","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"isRemotePool","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"}],"name":"isSupportedChain","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"isSupportedToken","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes","name":"receiver","type":"bytes"},{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"address","name":"originalSender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"localToken","type":"address"}],"internalType":"struct Pool.LockOrBurnInV1","name":"lockOrBurnIn","type":"tuple"}],"name":"lockOrBurn","outputs":[{"components":[{"internalType":"bytes","name":"destTokenAddress","type":"bytes"},{"internalType":"bytes","name":"destPoolData","type":"bytes"}],"internalType":"struct Pool.LockOrBurnOutV1","name":"","type":"tuple"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"provideLiquidity","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"bytes","name":"originalSender","type":"bytes"},{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"localToken","type":"address"},{"internalType":"bytes","name":"sourcePoolAddress","type":"bytes"},{"internalType":"bytes","name":"sourcePoolData","type":"bytes"},{"internalType":"bytes","name":"offchainTokenData","type":"bytes"}],"internalType":"struct Pool.ReleaseOrMintInV1","name":"releaseOrMintIn","type":"tuple"}],"name":"releaseOrMint","outputs":[{"components":[{"internalType":"uint256","name":"destinationAmount","type":"uint256"}],"internalType":"struct Pool.ReleaseOrMintOutV1","name":"","type":"tuple"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"internalType":"bytes","name":"remotePoolAddress","type":"bytes"}],"name":"removeRemotePool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint64","name":"remoteChainSelector","type":"uint64"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.Config","name":"outboundConfig","type":"tuple"},{"components":[{"internalType":"bool","name":"isEnabled","type":"bool"},{"internalType":"uint128","name":"capacity","type":"uint128"},{"internalType":"uint128","name":"rate","type":"uint128"}],"internalType":"struct RateLimiter.Config","name":"inboundConfig","type":"tuple"}],"name":"setChainRateLimiterConfig","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"rateLimitAdmin","type":"address"}],"name":"setRateLimitAdmin","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"rebalancer","type":"address"}],"name":"setRebalancer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newRouter","type":"address"}],"name":"setRouter","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferLiquidity","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"typeAndVersion","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawLiquidity","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
61012060405234801562000011575f80fd5b50604051620040cf380380620040cf833981016040819052620000349162000598565b8585858584335f816200005a57604051639b15e16f60e01b815260040160405180910390fd5b600180546001600160a01b0319166001600160a01b03848116919091179091558116156200008d576200008d81620001f0565b50506001600160a01b0385161580620000ad57506001600160a01b038116155b80620000c057506001600160a01b038216155b15620000df576040516342bcdf7f60e11b815260040160405180910390fd5b6001600160a01b03808616608081905290831660c0526040805163313ce56760e01b8152905163313ce567916004808201926020929091908290030181865afa9250505080156200014f575060408051601f3d908101601f191682019092526200014c91810190620006c4565b60015b156200018f578060ff168560ff16146200018d576040516332ad3e0760e11b815260ff80871660048301528216602482015260440160405180910390fd5b505b60ff841660a052600480546001600160a01b0319166001600160a01b038316179055825115801560e052620001d857604080515f815260208101909152620001d8908462000269565b50505050911515610100525062000728945050505050565b336001600160a01b038216036200021a57604051636d6c4ee560e11b815260040160405180910390fd5b5f80546001600160a01b0319166001600160a01b03838116918217835560015460405192939116917fed8889f560326eb138920d842192f0eb3dd22b4f139c87a2c57538e05bae12789190a350565b60e0516200028a576040516335f4a7b360e01b815260040160405180910390fd5b5f5b825181101562000313575f838281518110620002ac57620002ac620006e0565b60209081029190910101519050620002c6600282620003c1565b1562000309576040516001600160a01b03821681527f800671136ab6cfee9fbe5ed1fb7ca417811aca3cf864800d127b927adedf75669060200160405180910390a15b506001016200028c565b505f5b8151811015620003bc575f828281518110620003365762000336620006e0565b602002602001015190505f6001600160a01b0316816001600160a01b031603620003615750620003b3565b6200036e600282620003e0565b15620003b1576040516001600160a01b03821681527f2640d4d76caf8bf478aabfa982fa4e1c4eb71a37f93cd15e80dbc657911546d89060200160405180910390a15b505b60010162000316565b505050565b5f620003d7836001600160a01b038416620003f6565b90505b92915050565b5f620003d7836001600160a01b038416620004ea565b5f8181526001830160205260408120548015620004e0575f6200041b600183620006f4565b85549091505f906200043090600190620006f4565b905080821462000496575f865f018281548110620004525762000452620006e0565b905f5260205f200154905080875f018481548110620004755762000475620006e0565b5f918252602080832090910192909255918252600188019052604090208390555b8554869080620004aa57620004aa62000714565b600190038181905f5260205f20015f90559055856001015f8681526020019081526020015f205f905560019350505050620003da565b5f915050620003da565b5f8181526001830160205260408120546200053157508154600181810184555f848152602080822090930184905584548482528286019093526040902091909155620003da565b505f620003da565b6001600160a01b03811681146200054e575f80fd5b50565b805160ff8116811462000562575f80fd5b919050565b634e487b7160e01b5f52604160045260245ffd5b8051620005628162000539565b8051801515811462000562575f80fd5b5f805f805f8060c08789031215620005ae575f80fd5b8651620005bb8162000539565b95506020620005cc88820162000551565b60408901519096506001600160401b0380821115620005e9575f80fd5b818a0191508a601f830112620005fd575f80fd5b81518181111562000612576200061262000567565b8060051b604051601f19603f830116810181811085821117156200063a576200063a62000567565b60405291825284820192508381018501918d83111562000658575f80fd5b938501935b82851015620006815762000671856200057b565b845293850193928501926200065d565b80995050505050505062000698606088016200057b565b9250620006a86080880162000588565b9150620006b860a088016200057b565b90509295509295509295565b5f60208284031215620006d5575f80fd5b620003d78262000551565b634e487b7160e01b5f52603260045260245ffd5b81810381811115620003da57634e487b7160e01b5f52601160045260245ffd5b634e487b7160e01b5f52603160045260245ffd5b60805160a05160c05160e051610100516138dd620007f25f395f8181610513015261168101525f81816105ad01528181611c4501526124a001525f81816105870152818161186b0152611e9b01525f818161031301528181610c18015281816119b901528181611a3f01528181611a7301528181611aa501528181611af101528181611b490152611bb301525f8181610294015281816102dc0152818161067d0152818161071a015281816107fd015281816116f70152818161245201526125ed01526138dd5ff3fe608060405234801561000f575f80fd5b5060043610610208575f3560e01c80638da5cb5b1161011f578063c0d78655116100a9578063dc0bd97111610079578063dc0bd97114610585578063e0351e13146105ab578063e8a1da17146105d1578063eb521a4c146105e4578063f2fde38b146105f7575f80fd5b8063c0d7865514610537578063c4bffe2b1461054a578063c75eea9c1461055f578063cf7401f314610572575f80fd5b8063acfecf91116100ef578063acfecf9114610474578063af58d59f14610487578063b0f479a1146104ed578063b7946580146104fe578063bb98546b14610511575f80fd5b80638da5cb5b1461040e5780639a4575b91461041f578063a42a7b8b1461043f578063a7cd63b71461045f575f80fd5b80634c5ef0ed116101a05780636cfd1553116101705780636cfd1553146103bc5780636d3d1a58146103cf57806379ba5097146103e05780637d54534e146103e85780638926f54f146103fb575f80fd5b80634c5ef0ed1461037057806354c8a4f31461038357806362ddd3c41461039657806366320087146103a9575f80fd5b8063240028e8116101db578063240028e8146102cc57806324f65ee71461030c578063390775371461033d578063432a6ba31461035f575f80fd5b806301ffc9a71461020c5780630a861f2a14610234578063181f5a771461024957806321df0da714610292575b5f80fd5b61021f61021a366004612d33565b61060a565b60405190151581526020015b60405180910390f35b610247610242366004612d5a565b610634565b005b6102856040518060400160405280601a81526020017f4c6f636b52656c65617365546f6b656e506f6f6c20312e352e3100000000000081525081565b60405161022b9190612dbe565b7f00000000000000000000000000000000000000000000000000000000000000005b6040516001600160a01b03909116815260200161022b565b61021f6102da366004612de4565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811691161490565b60405160ff7f000000000000000000000000000000000000000000000000000000000000000016815260200161022b565b61035061034b366004612dff565b610770565b6040519051815260200161022b565b600a546001600160a01b03166102b4565b61021f61037e366004612e51565b610894565b610247610391366004612f13565b6108db565b6102476103a4366004612e51565b610954565b6102476103b7366004612f79565b6109d1565b6102476103ca366004612de4565b610a75565b6009546001600160a01b03166102b4565b610247610a9f565b6102476103f6366004612de4565b610b20565b61021f610409366004612fa3565b610b7c565b6001546001600160a01b03166102b4565b61043261042d366004612fbc565b610b91565b60405161022b9190612ff2565b61045261044d366004612fa3565b610c5d565b60405161022b919061302a565b610467610dbf565b60405161022b919061308c565b610247610482366004612e51565b610dd0565b61049a610495366004612fa3565b610eb2565b60405161022b919081516001600160801b03908116825260208084015163ffffffff1690830152604080840151151590830152606080840151821690830152608092830151169181019190915260a00190565b6004546001600160a01b03166102b4565b61028561050c366004612fa3565b610f5d565b7f000000000000000000000000000000000000000000000000000000000000000061021f565b610247610545366004612de4565b611009565b610552611099565b60405161022b91906130d8565b61049a61056d366004612fa3565b61114c565b610247610580366004613215565b6111f4565b7f00000000000000000000000000000000000000000000000000000000000000006102b4565b7f000000000000000000000000000000000000000000000000000000000000000061021f565b6102476105df366004612f13565b611245565b6102476105f2366004612d5a565b61167f565b610247610605366004612de4565b61174e565b5f6001600160e01b031982166370ea02b360e11b148061062e575061062e82611762565b92915050565b600a546001600160a01b031633146106665760405163472511eb60e11b81523360048201526024015b60405180910390fd5b6040516370a0823160e01b815230600482015281907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a0823190602401602060405180830381865afa1580156106ca573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906106ee9190613257565b101561070d5760405163bb55fd2760e01b815260040160405180910390fd5b6107416001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001633836117b2565b604051819033907fc2c3f06e49b9f15e7b4af9055e183b0d73362e033ad82a07dec9bf9840171719905f90a350565b60408051602081019091525f815261078782611815565b5f6107de60608401356107d96107a060c087018761326e565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284375f920191909152506119ad92505050565b611a3c565b90506108246107f36060850160408601612de4565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690836117b2565b6108346060840160408501612de4565b6001600160a01b0316336001600160a01b03167f2d87480f50083e2b2759522a8fdda59802650a8055e609a7772cf70c07748f528360405161087891815260200190565b60405180910390a3604080516020810190915290815292915050565b5f6108d383836040516108a89291906132b0565b60408051918290039091206001600160401b0387165f90815260076020529190912060050190611bfc565b949350505050565b6108e3611c16565b61094e8484808060200260200160405190810160405280939291908181526020018383602002808284375f92019190915250506040805160208088028281018201909352878252909350879250869182918501908490808284375f92019190915250611c4392505050565b50505050565b61095c611c16565b61096583610b7c565b61098d57604051631e670e4b60e01b81526001600160401b038416600482015260240161065d565b6109cc8383838080601f0160208091040260200160405190810160405280939291908181526020018383808284375f92019190915250611da792505050565b505050565b6109d9611c16565b6040516305430f9560e11b8152600481018290526001600160a01b03831690630a861f2a906024015f604051808303815f87803b158015610a18575f80fd5b505af1158015610a2a573d5f803e3d5ffd5b50505050816001600160a01b03167f6fa7abcf1345d1d478e5ea0da6b5f26a90eadb0546ef15ed3833944fbfd1db6282604051610a6991815260200190565b60405180910390a25050565b610a7d611c16565b600a80546001600160a01b0319166001600160a01b0392909216919091179055565b5f546001600160a01b03163314610ac95760405163015aa1e360e11b815260040160405180910390fd5b600180546001600160a01b0319808216339081179093555f805490911681556040516001600160a01b03909216929183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a350565b610b28611c16565b600980546001600160a01b0319166001600160a01b0383169081179091556040519081527f44676b5284b809a22248eba0da87391d79098be38bb03154be88a58bf4d091749060200160405180910390a150565b5f61062e60056001600160401b038416611bfc565b6040805180820190915260608082526020820152610bae82611e6a565b6040516060830135815233907f9f1ec8c880f76798e7b793325d625e9b60e4082a553c98f42b6cda368dd600089060200160405180910390a26040518060400160405280610c0884602001602081019061050c9190612fa3565b8152602001610c556040805160ff7f000000000000000000000000000000000000000000000000000000000000000016602082015260609101604051602081830303815290604052905090565b905292915050565b6001600160401b0381165f90815260076020526040812060609190610c8490600501611fa9565b90505f81516001600160401b03811115610ca057610ca0613118565b604051908082528060200260200182016040528015610cd357816020015b6060815260200190600190039081610cbe5790505b5090505f5b8251811015610db75760085f848381518110610cf657610cf66132bf565b602002602001015181526020019081526020015f208054610d16906132d3565b80601f0160208091040260200160405190810160405280929190818152602001828054610d42906132d3565b8015610d8d5780601f10610d6457610100808354040283529160200191610d8d565b820191905f5260205f20905b815481529060010190602001808311610d7057829003601f168201915b5050505050828281518110610da457610da46132bf565b6020908102919091010152600101610cd8565b509392505050565b6060610dcb6002611fa9565b905090565b610dd8611c16565b610de183610b7c565b610e0957604051631e670e4b60e01b81526001600160401b038416600482015260240161065d565b610e478282604051610e1c9291906132b0565b60408051918290039091206001600160401b0386165f90815260076020529190912060050190611fb5565b610e6a57828282604051631d3c8f1f60e21b815260040161065d93929190613333565b826001600160401b03167f52d00ee4d9bd51b40168f2afc5848837288ce258784ad914278791464b3f4d768383604051610ea5929190613355565b60405180910390a2505050565b6040805160a0810182525f808252602082018190529181018290526060810182905260808101919091526001600160401b0382165f90815260076020908152604091829020825160a08101845260028201546001600160801b038082168352600160801b80830463ffffffff1695840195909552600160a01b90910460ff16151594820194909452600390910154808416606083015291909104909116608082015261062e90611fc0565b6001600160401b0381165f908152600760205260409020600401805460609190610f86906132d3565b80601f0160208091040260200160405190810160405280929190818152602001828054610fb2906132d3565b8015610ffd5780601f10610fd457610100808354040283529160200191610ffd565b820191905f5260205f20905b815481529060010190602001808311610fe057829003601f168201915b50505050509050919050565b611011611c16565b6001600160a01b038116611038576040516342bcdf7f60e11b815260040160405180910390fd5b600480546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f02dc5c233404867c793b749c6d644beb2277536d18a7e7974d3f238e4c6f1684910160405180910390a15050565b60605f6110a66005611fa9565b90505f81516001600160401b038111156110c2576110c2613118565b6040519080825280602002602001820160405280156110eb578160200160208202803683370190505b5090505f5b82518110156111455782818151811061110b5761110b6132bf565b6020026020010151828281518110611125576111256132bf565b6001600160401b03909216602092830291909101909101526001016110f0565b5092915050565b6040805160a0810182525f808252602082018190529181018290526060810182905260808101919091526001600160401b0382165f90815260076020908152604091829020825160a08101845281546001600160801b038082168352600160801b80830463ffffffff1695840195909552600160a01b90910460ff16151594820194909452600190910154808416606083015291909104909116608082015261062e90611fc0565b6009546001600160a01b0316331480159061121a57506001546001600160a01b03163314155b1561123a5760405163472511eb60e11b815233600482015260240161065d565b6109cc83838361204c565b61124d611c16565b5f5b838110156113fa575f85858381811061126a5761126a6132bf565b905060200201602081019061127f9190612fa3565b905061129560056001600160401b038316611fb5565b6112bd57604051631e670e4b60e01b81526001600160401b038216600482015260240161065d565b6001600160401b0381165f9081526007602052604081206112e090600501611fa9565b90505f5b81518110156113475761133e828281518110611302576113026132bf565b602002602001015160075f866001600160401b03166001600160401b031681526020019081526020015f20600501611fb590919063ffffffff16565b506001016112e4565b506001600160401b0382165f90815260076020526040812080546001600160a81b0319908116825560018201839055600282018054909116905560038101829055906113966004830182612ccd565b600582015f81816113a78282612d04565b50506040516001600160401b03871681527f5204aec90a3c794d8e90fded8b46ae9c7c552803e7e832e0c1d358396d859916945060200192506113e8915050565b60405180910390a1505060010161124f565b505f5b81811015611678575f838383818110611418576114186132bf565b905060200281019061142a9190613368565b611433906133f2565b905061144381606001515f612116565b61145181608001515f612116565b8060400151515f03611476576040516342bcdf7f60e11b815260040160405180910390fd5b805161148d906005906001600160401b03166121db565b6114b8578051604051631d5ad3c560e01b81526001600160401b03909116600482015260240161065d565b80516001600160401b03165f90815260076020908152604091829020825160a08082018552606080870180518601516001600160801b0390811680865263ffffffff42168689018190528351511515878b0181905284518a0151841686890181905294518b0151841660809889018190528954600160a01b92830260ff60a01b19600160801b8087026001600160a01b031994851690981788178216929092178d5592810290971760018c01558c519889018d52898e0180518d01518716808b528a8e019590955280515115158a8f018190528151909d01518716988a01899052518d0151909516979098018790526002890180549a9091029990931617179094169590951790925590920290911760038201559082015160048201906115df9082613554565b505f5b82602001515181101561162157611619835f01518460200151838151811061160c5761160c6132bf565b6020026020010151611da7565b6001016115e2565b507f8d340f17e19058004c20453540862a9c62778504476f6756755cb33bcd6c38c2825f0151836040015184606001518560800151604051611666949392919061363d565b60405180910390a150506001016113fd565b5050505050565b7f00000000000000000000000000000000000000000000000000000000000000006116bd57604051633a4fe3e960e21b815260040160405180910390fd5b600a546001600160a01b031633146116ea5760405163472511eb60e11b815233600482015260240161065d565b61171f6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163330846121e6565b604051819033907fc17cea59c2955cb181b03393209566960365771dbba9dc3d510180e7cb312088905f90a350565b611756611c16565b61175f8161221e565b50565b5f6001600160e01b0319821663aff2afbf60e01b148061179257506001600160e01b03198216630e64dd2960e01b145b8061062e57506001600160e01b031982166301ffc9a760e01b1492915050565b6040516001600160a01b0383166024820152604481018290526109cc90849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152612296565b6118286102da60a0830160808401612de4565b6118615761183c60a0820160808301612de4565b60405163961c9a4f60e01b81526001600160a01b03909116600482015260240161065d565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016632cbc26bb6118a06040840160208501612fa3565b60405160e083901b6001600160e01b031916815260809190911b67ffffffffffffffff60801b166004820152602401602060405180830381865afa1580156118ea573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061190e919061367c565b1561192c57604051630a75a23b60e31b815260040160405180910390fd5b61194461193f6040830160208401612fa3565b612367565b6119646119576040830160208401612fa3565b61037e60a084018461326e565b6119905761197560a082018261326e565b6040516324eb47e560e01b815260040161065d929190613355565b61175f6119a36040830160208401612fa3565b8260600135612431565b5f81515f036119dd57507f0000000000000000000000000000000000000000000000000000000000000000919050565b8151602014611a01578160405163953576f760e01b815260040161065d9190612dbe565b5f82806020019051810190611a169190613257565b905060ff81111561062e578260405163953576f760e01b815260040161065d9190612dbe565b5f7f000000000000000000000000000000000000000000000000000000000000000060ff168260ff1603611a7157508161062e565b7f000000000000000000000000000000000000000000000000000000000000000060ff168260ff161115611b42575f611aca7f0000000000000000000000000000000000000000000000000000000000000000846136ab565b9050604d8160ff161115611b255760405163a9cb113d60e01b815260ff80851660048301527f00000000000000000000000000000000000000000000000000000000000000001660248201526044810185905260640161065d565b611b3081600a6137a4565b611b3a90856137b2565b91505061062e565b5f611b6d837f00000000000000000000000000000000000000000000000000000000000000006136ab565b9050604d8160ff161180611b955750611b8781600a6137a4565b611b92905f196137b2565b84115b15611be75760405163a9cb113d60e01b815260ff80851660048301527f00000000000000000000000000000000000000000000000000000000000000001660248201526044810185905260640161065d565b611bf281600a6137a4565b6108d390856137d1565b5f81815260018301602052604081205415155b9392505050565b6001546001600160a01b03163314611c41576040516315ae3a6f60e11b815260040160405180910390fd5b565b7f0000000000000000000000000000000000000000000000000000000000000000611c81576040516335f4a7b360e01b815260040160405180910390fd5b5f5b8251811015611d08575f838281518110611c9f57611c9f6132bf565b60200260200101519050611cbd81600261247690919063ffffffff16565b15611cff576040516001600160a01b03821681527f800671136ab6cfee9fbe5ed1fb7ca417811aca3cf864800d127b927adedf75669060200160405180910390a15b50600101611c83565b505f5b81518110156109cc575f828281518110611d2757611d276132bf565b602002602001015190505f6001600160a01b0316816001600160a01b031603611d505750611d9f565b611d5b60028261248a565b15611d9d576040516001600160a01b03821681527f2640d4d76caf8bf478aabfa982fa4e1c4eb71a37f93cd15e80dbc657911546d89060200160405180910390a15b505b600101611d0b565b80515f03611dc8576040516342bcdf7f60e11b815260040160405180910390fd5b80516020808301919091206001600160401b0384165f90815260079092526040909120611df890600501826121db565b611e19578282604051631c9dc56960e11b815260040161065d9291906137e8565b5f818152600860205260409020611e308382613554565b50826001600160401b03167f7d628c9a1796743d365ab521a8b2a4686e419b3269919dc9145ea2ce853b54ea83604051610ea59190612dbe565b611e7d6102da60a0830160808401612de4565b611e915761183c60a0820160808301612de4565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016632cbc26bb611ed06040840160208501612fa3565b60405160e083901b6001600160e01b031916815260809190911b67ffffffffffffffff60801b166004820152602401602060405180830381865afa158015611f1a573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611f3e919061367c565b15611f5c57604051630a75a23b60e31b815260040160405180910390fd5b611f74611f6f6060830160408401612de4565b61249e565b611f8c611f876040830160208401612fa3565b6124f7565b61175f611f9f6040830160208401612fa3565b82606001356125cf565b60605f611c0f83612611565b5f611c0f8383612669565b6040805160a0810182525f8082526020820181905291810182905260608101829052608081019190915261203182606001516001600160801b0316835f01516001600160801b0316846020015163ffffffff164261201e9190613809565b85608001516001600160801b031661274c565b6001600160801b031682525063ffffffff4216602082015290565b61205583610b7c565b61207d57604051631e670e4b60e01b81526001600160401b038416600482015260240161065d565b612087825f612116565b6001600160401b0383165f9081526007602052604090206120a89083612773565b6120b2815f612116565b6001600160401b0383165f9081526007602052604090206120d69060020182612773565b7f0350d63aa5f270e01729d00d627eeb8f3429772b1818c016c66a588a864f912b8383836040516121099392919061381c565b60405180910390a1505050565b8151156121945781602001516001600160801b031682604001516001600160801b0316101580612151575060408201516001600160801b0316155b156121715781604051632008344960e21b815260040161065d9190613846565b80156121905760405163433fc33d60e01b815260040160405180910390fd5b5050565b60408201516001600160801b03161515806121bb575060208201516001600160801b031615155b1561219057816040516335a2be7360e21b815260040161065d9190613846565b5f611c0f8383612889565b6040516001600160a01b038085166024830152831660448201526064810182905261094e9085906323b872dd60e01b906084016117de565b336001600160a01b0382160361224757604051636d6c4ee560e11b815260040160405180910390fd5b5f80546001600160a01b0319166001600160a01b03838116918217835560015460405192939116917fed8889f560326eb138920d842192f0eb3dd22b4f139c87a2c57538e05bae12789190a350565b5f6122ea826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166128d59092919063ffffffff16565b8051909150156109cc5780806020019051810190612308919061367c565b6109cc5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161065d565b61237081610b7c565b612398576040516354c8163f60e11b81526001600160401b038216600482015260240161065d565b600480546040516383826b2b60e01b81526001600160401b038416928101929092523360248301526001600160a01b0316906383826b2b90604401602060405180830381865afa1580156123ee573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612412919061367c565b61175f5760405163728fe07b60e01b815233600482015260240161065d565b6001600160401b0382165f90815260076020526040902061219090600201827f00000000000000000000000000000000000000000000000000000000000000006128e3565b5f611c0f836001600160a01b038416612669565b5f611c0f836001600160a01b038416612889565b7f00000000000000000000000000000000000000000000000000000000000000001561175f576124cf600282612b23565b61175f576040516368692cbb60e11b81526001600160a01b038216600482015260240161065d565b61250081610b7c565b612528576040516354c8163f60e11b81526001600160401b038216600482015260240161065d565b6004805460405163a8d87a3b60e01b81526001600160401b038416928101929092526001600160a01b03169063a8d87a3b90602401602060405180830381865afa158015612578573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061259c9190613854565b6001600160a01b0316336001600160a01b03161461175f5760405163728fe07b60e01b815233600482015260240161065d565b6001600160401b0382165f90815260076020526040902061219090827f00000000000000000000000000000000000000000000000000000000000000006128e3565b6060815f01805480602002602001604051908101604052809291908181526020018280548015610ffd57602002820191905f5260205f20905b81548152602001906001019080831161264a5750505050509050919050565b5f8181526001830160205260408120548015612743575f61268b600183613809565b85549091505f9061269e90600190613809565b90508082146126fd575f865f0182815481106126bc576126bc6132bf565b905f5260205f200154905080875f0184815481106126dc576126dc6132bf565b5f918252602080832090910192909255918252600188019052604090208390555b855486908061270e5761270e61386f565b600190038181905f5260205f20015f90559055856001015f8681526020019081526020015f205f90556001935050505061062e565b5f91505061062e565b5f61276a8561275b84866137d1565b6127659087613883565b612b44565b95945050505050565b81545f9061278e90600160801b900463ffffffff1642613809565b905080156127ec57600183015483546127c0916001600160801b03808216928116918591600160801b9091041661274c565b83546001600160801b03919091166001600160a01b031990911617600160801b4263ffffffff16021783555b60208201518354612809916001600160801b039081169116612b44565b835483511515600160a01b0274ff00000000ffffffffffffffffffffffffffffffff199091166001600160801b039283161717845560208301516040808501518316600160801b0291909216176001850155517f9ea3374b67bf275e6bb9c8ae68f9cae023e1c528b4b27e092f0bb209d3531c1990612109908490613846565b5f8181526001830160205260408120546128ce57508154600181810184555f84815260208082209093018490558454848252828601909352604090209190915561062e565b505f61062e565b60606108d384845f85612b59565b8254600160a01b900460ff1615806128f9575081155b1561290357505050565b825460018401546001600160801b03808316929116905f9061293290600160801b900463ffffffff1642613809565b9050801561299e578183111561295b57604051634b92ca1560e11b815260040160405180910390fd5b600186015461297f90839085908490600160801b90046001600160801b031661274c565b865463ffffffff60801b1916600160801b4263ffffffff160217875592505b84821015612a09576001600160a01b0384166129d75760405163f94ebcd160e01b8152600481018390526024810186905260440161065d565b604051630d3b2b9560e11b815260048101839052602481018690526001600160a01b038516604482015260640161065d565b84831015612ab957600186810154600160801b90046001600160801b0316905f908290612a369082613809565b612a40878a613809565b612a4a9190613883565b612a5491906137b2565b90506001600160a01b038616612a87576040516302a4f38160e31b8152600481018290526024810186905260440161065d565b604051636864691d60e11b815260048101829052602481018690526001600160a01b038716604482015260640161065d565b612ac38584613809565b86546fffffffffffffffffffffffffffffffff19166001600160801b0382161787556040518681529093507f1871cdf8010e63f2eb8384381a68dfa7416dc571a5517e66e88b2d2d0c0a690a9060200160405180910390a1505050505050565b6001600160a01b0381165f9081526001830160205260408120541515611c0f565b5f818310612b525781611c0f565b5090919050565b606082471015612bba5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161065d565b5f80866001600160a01b03168587604051612bd59190613896565b5f6040518083038185875af1925050503d805f8114612c0f576040519150601f19603f3d011682016040523d82523d5f602084013e612c14565b606091505b5091509150612c2587838387612c30565b979650505050505050565b60608315612c9e5782515f03612c97576001600160a01b0385163b612c975760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161065d565b50816108d3565b6108d38383815115612cb35781518083602001fd5b8060405162461bcd60e51b815260040161065d9190612dbe565b508054612cd9906132d3565b5f825580601f10612ce8575050565b601f0160209004905f5260205f209081019061175f9190612d1b565b5080545f8255905f5260205f209081019061175f91905b5b80821115612d2f575f8155600101612d1c565b5090565b5f60208284031215612d43575f80fd5b81356001600160e01b031981168114611c0f575f80fd5b5f60208284031215612d6a575f80fd5b5035919050565b5f5b83811015612d8b578181015183820152602001612d73565b50505f910152565b5f8151808452612daa816020860160208601612d71565b601f01601f19169290920160200192915050565b602081525f611c0f6020830184612d93565b6001600160a01b038116811461175f575f80fd5b5f60208284031215612df4575f80fd5b8135611c0f81612dd0565b5f60208284031215612e0f575f80fd5b81356001600160401b03811115612e24575f80fd5b82016101008185031215611c0f575f80fd5b80356001600160401b0381168114612e4c575f80fd5b919050565b5f805f60408486031215612e63575f80fd5b612e6c84612e36565b925060208401356001600160401b0380821115612e87575f80fd5b818601915086601f830112612e9a575f80fd5b813581811115612ea8575f80fd5b876020828501011115612eb9575f80fd5b6020830194508093505050509250925092565b5f8083601f840112612edc575f80fd5b5081356001600160401b03811115612ef2575f80fd5b6020830191508360208260051b8501011115612f0c575f80fd5b9250929050565b5f805f8060408587031215612f26575f80fd5b84356001600160401b0380821115612f3c575f80fd5b612f4888838901612ecc565b90965094506020870135915080821115612f60575f80fd5b50612f6d87828801612ecc565b95989497509550505050565b5f8060408385031215612f8a575f80fd5b8235612f9581612dd0565b946020939093013593505050565b5f60208284031215612fb3575f80fd5b611c0f82612e36565b5f60208284031215612fcc575f80fd5b81356001600160401b03811115612fe1575f80fd5b820160a08185031215611c0f575f80fd5b602081525f82516040602084015261300d6060840182612d93565b90506020840151601f1984830301604085015261276a8282612d93565b5f60208083016020845280855180835260408601915060408160051b8701019250602087015f5b8281101561307f57603f1988860301845261306d858351612d93565b94509285019290850190600101613051565b5092979650505050505050565b602080825282518282018190525f9190848201906040850190845b818110156130cc5783516001600160a01b0316835292840192918401916001016130a7565b50909695505050505050565b602080825282518282018190525f9190848201906040850190845b818110156130cc5783516001600160401b0316835292840192918401916001016130f3565b634e487b7160e01b5f52604160045260245ffd5b60405160a081016001600160401b038111828210171561314e5761314e613118565b60405290565b604051601f8201601f191681016001600160401b038111828210171561317c5761317c613118565b604052919050565b801515811461175f575f80fd5b80356001600160801b0381168114612e4c575f80fd5b5f606082840312156131b7575f80fd5b604051606081018181106001600160401b03821117156131d9576131d9613118565b60405290508082356131ea81613184565b81526131f860208401613191565b602082015261320960408401613191565b60408201525092915050565b5f805f60e08486031215613227575f80fd5b61323084612e36565b925061323f85602086016131a7565b915061324e85608086016131a7565b90509250925092565b5f60208284031215613267575f80fd5b5051919050565b5f808335601e19843603018112613283575f80fd5b8301803591506001600160401b0382111561329c575f80fd5b602001915036819003821315612f0c575f80fd5b818382375f9101908152919050565b634e487b7160e01b5f52603260045260245ffd5b600181811c908216806132e757607f821691505b60208210810361330557634e487b7160e01b5f52602260045260245ffd5b50919050565b81835281816020850137505f828201602090810191909152601f909101601f19169091010190565b6001600160401b0384168152604060208201525f61276a60408301848661330b565b602081525f6108d360208301848661330b565b5f823561011e1983360301811261337d575f80fd5b9190910192915050565b5f82601f830112613396575f80fd5b81356001600160401b038111156133af576133af613118565b6133c2601f8201601f1916602001613154565b8181528460208386010111156133d6575f80fd5b816020850160208301375f918101602001919091529392505050565b5f6101208236031215613403575f80fd5b61340b61312c565b61341483612e36565b81526020808401356001600160401b0380821115613430575f80fd5b9085019036601f830112613442575f80fd5b81358181111561345457613454613118565b8060051b613463858201613154565b918252838101850191858101903684111561347c575f80fd5b86860192505b838310156134b657823585811115613498575f80fd5b6134a63689838a0101613387565b8352509186019190860190613482565b80878901525050505060408601359250808311156134d2575f80fd5b50506134e036828601613387565b6040830152506134f336606085016131a7565b60608201526135053660c085016131a7565b608082015292915050565b601f8211156109cc57805f5260205f20601f840160051c810160208510156135355750805b601f840160051c820191505b81811015611678575f8155600101613541565b81516001600160401b0381111561356d5761356d613118565b6135818161357b84546132d3565b84613510565b602080601f8311600181146135b4575f841561359d5750858301515b5f19600386901b1c1916600185901b17855561360b565b5f85815260208120601f198616915b828110156135e2578886015182559484019460019091019084016135c3565b50858210156135ff57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b8051151582526020808201516001600160801b039081169184019190915260409182015116910152565b5f6101006001600160401b038716835280602084015261365f81840187612d93565b91505061366f6040830185613613565b61276a60a0830184613613565b5f6020828403121561368c575f80fd5b8151611c0f81613184565b634e487b7160e01b5f52601160045260245ffd5b60ff828116828216039081111561062e5761062e613697565b600181815b808511156136fe57815f19048211156136e4576136e4613697565b808516156136f157918102915b93841c93908002906136c9565b509250929050565b5f826137145750600161062e565b8161372057505f61062e565b816001811461373657600281146137405761375c565b600191505061062e565b60ff84111561375157613751613697565b50506001821b61062e565b5060208310610133831016604e8410600b841016171561377f575081810a61062e565b61378983836136c4565b805f190482111561379c5761379c613697565b029392505050565b5f611c0f60ff841683613706565b5f826137cc57634e487b7160e01b5f52601260045260245ffd5b500490565b808202811582820484141761062e5761062e613697565b6001600160401b0383168152604060208201525f6108d36040830184612d93565b8181038181111561062e5761062e613697565b6001600160401b038416815260e081016138396020830185613613565b6108d36080830184613613565b6060810161062e8284613613565b5f60208284031215613864575f80fd5b8151611c0f81612dd0565b634e487b7160e01b5f52603160045260245ffd5b8082018082111561062e5761062e613697565b5f825161337d818460208701612d7156fea2646970667358221220ca42d72bbc2c13e408cb23f2fd2c2366f7e2eed37043c109ab8ac568e0e89e2464736f6c63430008180033000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000411de17f12d1a34ecc7f45f49844626267c75e81000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080226fc0ee2b096224eeac085bb9a8cba1146f7d0000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x608060405234801561000f575f80fd5b5060043610610208575f3560e01c80638da5cb5b1161011f578063c0d78655116100a9578063dc0bd97111610079578063dc0bd97114610585578063e0351e13146105ab578063e8a1da17146105d1578063eb521a4c146105e4578063f2fde38b146105f7575f80fd5b8063c0d7865514610537578063c4bffe2b1461054a578063c75eea9c1461055f578063cf7401f314610572575f80fd5b8063acfecf91116100ef578063acfecf9114610474578063af58d59f14610487578063b0f479a1146104ed578063b7946580146104fe578063bb98546b14610511575f80fd5b80638da5cb5b1461040e5780639a4575b91461041f578063a42a7b8b1461043f578063a7cd63b71461045f575f80fd5b80634c5ef0ed116101a05780636cfd1553116101705780636cfd1553146103bc5780636d3d1a58146103cf57806379ba5097146103e05780637d54534e146103e85780638926f54f146103fb575f80fd5b80634c5ef0ed1461037057806354c8a4f31461038357806362ddd3c41461039657806366320087146103a9575f80fd5b8063240028e8116101db578063240028e8146102cc57806324f65ee71461030c578063390775371461033d578063432a6ba31461035f575f80fd5b806301ffc9a71461020c5780630a861f2a14610234578063181f5a771461024957806321df0da714610292575b5f80fd5b61021f61021a366004612d33565b61060a565b60405190151581526020015b60405180910390f35b610247610242366004612d5a565b610634565b005b6102856040518060400160405280601a81526020017f4c6f636b52656c65617365546f6b656e506f6f6c20312e352e3100000000000081525081565b60405161022b9190612dbe565b7f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e5b6040516001600160a01b03909116815260200161022b565b61021f6102da366004612de4565b7f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e6001600160a01b0390811691161490565b60405160ff7f000000000000000000000000000000000000000000000000000000000000001216815260200161022b565b61035061034b366004612dff565b610770565b6040519051815260200161022b565b600a546001600160a01b03166102b4565b61021f61037e366004612e51565b610894565b610247610391366004612f13565b6108db565b6102476103a4366004612e51565b610954565b6102476103b7366004612f79565b6109d1565b6102476103ca366004612de4565b610a75565b6009546001600160a01b03166102b4565b610247610a9f565b6102476103f6366004612de4565b610b20565b61021f610409366004612fa3565b610b7c565b6001546001600160a01b03166102b4565b61043261042d366004612fbc565b610b91565b60405161022b9190612ff2565b61045261044d366004612fa3565b610c5d565b60405161022b919061302a565b610467610dbf565b60405161022b919061308c565b610247610482366004612e51565b610dd0565b61049a610495366004612fa3565b610eb2565b60405161022b919081516001600160801b03908116825260208084015163ffffffff1690830152604080840151151590830152606080840151821690830152608092830151169181019190915260a00190565b6004546001600160a01b03166102b4565b61028561050c366004612fa3565b610f5d565b7f000000000000000000000000000000000000000000000000000000000000000061021f565b610247610545366004612de4565b611009565b610552611099565b60405161022b91906130d8565b61049a61056d366004612fa3565b61114c565b610247610580366004613215565b6111f4565b7f000000000000000000000000411de17f12d1a34ecc7f45f49844626267c75e816102b4565b7f000000000000000000000000000000000000000000000000000000000000000061021f565b6102476105df366004612f13565b611245565b6102476105f2366004612d5a565b61167f565b610247610605366004612de4565b61174e565b5f6001600160e01b031982166370ea02b360e11b148061062e575061062e82611762565b92915050565b600a546001600160a01b031633146106665760405163472511eb60e11b81523360048201526024015b60405180910390fd5b6040516370a0823160e01b815230600482015281907f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e6001600160a01b0316906370a0823190602401602060405180830381865afa1580156106ca573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906106ee9190613257565b101561070d5760405163bb55fd2760e01b815260040160405180910390fd5b6107416001600160a01b037f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e1633836117b2565b604051819033907fc2c3f06e49b9f15e7b4af9055e183b0d73362e033ad82a07dec9bf9840171719905f90a350565b60408051602081019091525f815261078782611815565b5f6107de60608401356107d96107a060c087018761326e565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284375f920191909152506119ad92505050565b611a3c565b90506108246107f36060850160408601612de4565b6001600160a01b037f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e1690836117b2565b6108346060840160408501612de4565b6001600160a01b0316336001600160a01b03167f2d87480f50083e2b2759522a8fdda59802650a8055e609a7772cf70c07748f528360405161087891815260200190565b60405180910390a3604080516020810190915290815292915050565b5f6108d383836040516108a89291906132b0565b60408051918290039091206001600160401b0387165f90815260076020529190912060050190611bfc565b949350505050565b6108e3611c16565b61094e8484808060200260200160405190810160405280939291908181526020018383602002808284375f92019190915250506040805160208088028281018201909352878252909350879250869182918501908490808284375f92019190915250611c4392505050565b50505050565b61095c611c16565b61096583610b7c565b61098d57604051631e670e4b60e01b81526001600160401b038416600482015260240161065d565b6109cc8383838080601f0160208091040260200160405190810160405280939291908181526020018383808284375f92019190915250611da792505050565b505050565b6109d9611c16565b6040516305430f9560e11b8152600481018290526001600160a01b03831690630a861f2a906024015f604051808303815f87803b158015610a18575f80fd5b505af1158015610a2a573d5f803e3d5ffd5b50505050816001600160a01b03167f6fa7abcf1345d1d478e5ea0da6b5f26a90eadb0546ef15ed3833944fbfd1db6282604051610a6991815260200190565b60405180910390a25050565b610a7d611c16565b600a80546001600160a01b0319166001600160a01b0392909216919091179055565b5f546001600160a01b03163314610ac95760405163015aa1e360e11b815260040160405180910390fd5b600180546001600160a01b0319808216339081179093555f805490911681556040516001600160a01b03909216929183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a350565b610b28611c16565b600980546001600160a01b0319166001600160a01b0383169081179091556040519081527f44676b5284b809a22248eba0da87391d79098be38bb03154be88a58bf4d091749060200160405180910390a150565b5f61062e60056001600160401b038416611bfc565b6040805180820190915260608082526020820152610bae82611e6a565b6040516060830135815233907f9f1ec8c880f76798e7b793325d625e9b60e4082a553c98f42b6cda368dd600089060200160405180910390a26040518060400160405280610c0884602001602081019061050c9190612fa3565b8152602001610c556040805160ff7f000000000000000000000000000000000000000000000000000000000000001216602082015260609101604051602081830303815290604052905090565b905292915050565b6001600160401b0381165f90815260076020526040812060609190610c8490600501611fa9565b90505f81516001600160401b03811115610ca057610ca0613118565b604051908082528060200260200182016040528015610cd357816020015b6060815260200190600190039081610cbe5790505b5090505f5b8251811015610db75760085f848381518110610cf657610cf66132bf565b602002602001015181526020019081526020015f208054610d16906132d3565b80601f0160208091040260200160405190810160405280929190818152602001828054610d42906132d3565b8015610d8d5780601f10610d6457610100808354040283529160200191610d8d565b820191905f5260205f20905b815481529060010190602001808311610d7057829003601f168201915b5050505050828281518110610da457610da46132bf565b6020908102919091010152600101610cd8565b509392505050565b6060610dcb6002611fa9565b905090565b610dd8611c16565b610de183610b7c565b610e0957604051631e670e4b60e01b81526001600160401b038416600482015260240161065d565b610e478282604051610e1c9291906132b0565b60408051918290039091206001600160401b0386165f90815260076020529190912060050190611fb5565b610e6a57828282604051631d3c8f1f60e21b815260040161065d93929190613333565b826001600160401b03167f52d00ee4d9bd51b40168f2afc5848837288ce258784ad914278791464b3f4d768383604051610ea5929190613355565b60405180910390a2505050565b6040805160a0810182525f808252602082018190529181018290526060810182905260808101919091526001600160401b0382165f90815260076020908152604091829020825160a08101845260028201546001600160801b038082168352600160801b80830463ffffffff1695840195909552600160a01b90910460ff16151594820194909452600390910154808416606083015291909104909116608082015261062e90611fc0565b6001600160401b0381165f908152600760205260409020600401805460609190610f86906132d3565b80601f0160208091040260200160405190810160405280929190818152602001828054610fb2906132d3565b8015610ffd5780601f10610fd457610100808354040283529160200191610ffd565b820191905f5260205f20905b815481529060010190602001808311610fe057829003601f168201915b50505050509050919050565b611011611c16565b6001600160a01b038116611038576040516342bcdf7f60e11b815260040160405180910390fd5b600480546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f02dc5c233404867c793b749c6d644beb2277536d18a7e7974d3f238e4c6f1684910160405180910390a15050565b60605f6110a66005611fa9565b90505f81516001600160401b038111156110c2576110c2613118565b6040519080825280602002602001820160405280156110eb578160200160208202803683370190505b5090505f5b82518110156111455782818151811061110b5761110b6132bf565b6020026020010151828281518110611125576111256132bf565b6001600160401b03909216602092830291909101909101526001016110f0565b5092915050565b6040805160a0810182525f808252602082018190529181018290526060810182905260808101919091526001600160401b0382165f90815260076020908152604091829020825160a08101845281546001600160801b038082168352600160801b80830463ffffffff1695840195909552600160a01b90910460ff16151594820194909452600190910154808416606083015291909104909116608082015261062e90611fc0565b6009546001600160a01b0316331480159061121a57506001546001600160a01b03163314155b1561123a5760405163472511eb60e11b815233600482015260240161065d565b6109cc83838361204c565b61124d611c16565b5f5b838110156113fa575f85858381811061126a5761126a6132bf565b905060200201602081019061127f9190612fa3565b905061129560056001600160401b038316611fb5565b6112bd57604051631e670e4b60e01b81526001600160401b038216600482015260240161065d565b6001600160401b0381165f9081526007602052604081206112e090600501611fa9565b90505f5b81518110156113475761133e828281518110611302576113026132bf565b602002602001015160075f866001600160401b03166001600160401b031681526020019081526020015f20600501611fb590919063ffffffff16565b506001016112e4565b506001600160401b0382165f90815260076020526040812080546001600160a81b0319908116825560018201839055600282018054909116905560038101829055906113966004830182612ccd565b600582015f81816113a78282612d04565b50506040516001600160401b03871681527f5204aec90a3c794d8e90fded8b46ae9c7c552803e7e832e0c1d358396d859916945060200192506113e8915050565b60405180910390a1505060010161124f565b505f5b81811015611678575f838383818110611418576114186132bf565b905060200281019061142a9190613368565b611433906133f2565b905061144381606001515f612116565b61145181608001515f612116565b8060400151515f03611476576040516342bcdf7f60e11b815260040160405180910390fd5b805161148d906005906001600160401b03166121db565b6114b8578051604051631d5ad3c560e01b81526001600160401b03909116600482015260240161065d565b80516001600160401b03165f90815260076020908152604091829020825160a08082018552606080870180518601516001600160801b0390811680865263ffffffff42168689018190528351511515878b0181905284518a0151841686890181905294518b0151841660809889018190528954600160a01b92830260ff60a01b19600160801b8087026001600160a01b031994851690981788178216929092178d5592810290971760018c01558c519889018d52898e0180518d01518716808b528a8e019590955280515115158a8f018190528151909d01518716988a01899052518d0151909516979098018790526002890180549a9091029990931617179094169590951790925590920290911760038201559082015160048201906115df9082613554565b505f5b82602001515181101561162157611619835f01518460200151838151811061160c5761160c6132bf565b6020026020010151611da7565b6001016115e2565b507f8d340f17e19058004c20453540862a9c62778504476f6756755cb33bcd6c38c2825f0151836040015184606001518560800151604051611666949392919061363d565b60405180910390a150506001016113fd565b5050505050565b7f00000000000000000000000000000000000000000000000000000000000000006116bd57604051633a4fe3e960e21b815260040160405180910390fd5b600a546001600160a01b031633146116ea5760405163472511eb60e11b815233600482015260240161065d565b61171f6001600160a01b037f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e163330846121e6565b604051819033907fc17cea59c2955cb181b03393209566960365771dbba9dc3d510180e7cb312088905f90a350565b611756611c16565b61175f8161221e565b50565b5f6001600160e01b0319821663aff2afbf60e01b148061179257506001600160e01b03198216630e64dd2960e01b145b8061062e57506001600160e01b031982166301ffc9a760e01b1492915050565b6040516001600160a01b0383166024820152604481018290526109cc90849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152612296565b6118286102da60a0830160808401612de4565b6118615761183c60a0820160808301612de4565b60405163961c9a4f60e01b81526001600160a01b03909116600482015260240161065d565b6001600160a01b037f000000000000000000000000411de17f12d1a34ecc7f45f49844626267c75e8116632cbc26bb6118a06040840160208501612fa3565b60405160e083901b6001600160e01b031916815260809190911b67ffffffffffffffff60801b166004820152602401602060405180830381865afa1580156118ea573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061190e919061367c565b1561192c57604051630a75a23b60e31b815260040160405180910390fd5b61194461193f6040830160208401612fa3565b612367565b6119646119576040830160208401612fa3565b61037e60a084018461326e565b6119905761197560a082018261326e565b6040516324eb47e560e01b815260040161065d929190613355565b61175f6119a36040830160208401612fa3565b8260600135612431565b5f81515f036119dd57507f0000000000000000000000000000000000000000000000000000000000000012919050565b8151602014611a01578160405163953576f760e01b815260040161065d9190612dbe565b5f82806020019051810190611a169190613257565b905060ff81111561062e578260405163953576f760e01b815260040161065d9190612dbe565b5f7f000000000000000000000000000000000000000000000000000000000000001260ff168260ff1603611a7157508161062e565b7f000000000000000000000000000000000000000000000000000000000000001260ff168260ff161115611b42575f611aca7f0000000000000000000000000000000000000000000000000000000000000012846136ab565b9050604d8160ff161115611b255760405163a9cb113d60e01b815260ff80851660048301527f00000000000000000000000000000000000000000000000000000000000000121660248201526044810185905260640161065d565b611b3081600a6137a4565b611b3a90856137b2565b91505061062e565b5f611b6d837f00000000000000000000000000000000000000000000000000000000000000126136ab565b9050604d8160ff161180611b955750611b8781600a6137a4565b611b92905f196137b2565b84115b15611be75760405163a9cb113d60e01b815260ff80851660048301527f00000000000000000000000000000000000000000000000000000000000000121660248201526044810185905260640161065d565b611bf281600a6137a4565b6108d390856137d1565b5f81815260018301602052604081205415155b9392505050565b6001546001600160a01b03163314611c41576040516315ae3a6f60e11b815260040160405180910390fd5b565b7f0000000000000000000000000000000000000000000000000000000000000000611c81576040516335f4a7b360e01b815260040160405180910390fd5b5f5b8251811015611d08575f838281518110611c9f57611c9f6132bf565b60200260200101519050611cbd81600261247690919063ffffffff16565b15611cff576040516001600160a01b03821681527f800671136ab6cfee9fbe5ed1fb7ca417811aca3cf864800d127b927adedf75669060200160405180910390a15b50600101611c83565b505f5b81518110156109cc575f828281518110611d2757611d276132bf565b602002602001015190505f6001600160a01b0316816001600160a01b031603611d505750611d9f565b611d5b60028261248a565b15611d9d576040516001600160a01b03821681527f2640d4d76caf8bf478aabfa982fa4e1c4eb71a37f93cd15e80dbc657911546d89060200160405180910390a15b505b600101611d0b565b80515f03611dc8576040516342bcdf7f60e11b815260040160405180910390fd5b80516020808301919091206001600160401b0384165f90815260079092526040909120611df890600501826121db565b611e19578282604051631c9dc56960e11b815260040161065d9291906137e8565b5f818152600860205260409020611e308382613554565b50826001600160401b03167f7d628c9a1796743d365ab521a8b2a4686e419b3269919dc9145ea2ce853b54ea83604051610ea59190612dbe565b611e7d6102da60a0830160808401612de4565b611e915761183c60a0820160808301612de4565b6001600160a01b037f000000000000000000000000411de17f12d1a34ecc7f45f49844626267c75e8116632cbc26bb611ed06040840160208501612fa3565b60405160e083901b6001600160e01b031916815260809190911b67ffffffffffffffff60801b166004820152602401602060405180830381865afa158015611f1a573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611f3e919061367c565b15611f5c57604051630a75a23b60e31b815260040160405180910390fd5b611f74611f6f6060830160408401612de4565b61249e565b611f8c611f876040830160208401612fa3565b6124f7565b61175f611f9f6040830160208401612fa3565b82606001356125cf565b60605f611c0f83612611565b5f611c0f8383612669565b6040805160a0810182525f8082526020820181905291810182905260608101829052608081019190915261203182606001516001600160801b0316835f01516001600160801b0316846020015163ffffffff164261201e9190613809565b85608001516001600160801b031661274c565b6001600160801b031682525063ffffffff4216602082015290565b61205583610b7c565b61207d57604051631e670e4b60e01b81526001600160401b038416600482015260240161065d565b612087825f612116565b6001600160401b0383165f9081526007602052604090206120a89083612773565b6120b2815f612116565b6001600160401b0383165f9081526007602052604090206120d69060020182612773565b7f0350d63aa5f270e01729d00d627eeb8f3429772b1818c016c66a588a864f912b8383836040516121099392919061381c565b60405180910390a1505050565b8151156121945781602001516001600160801b031682604001516001600160801b0316101580612151575060408201516001600160801b0316155b156121715781604051632008344960e21b815260040161065d9190613846565b80156121905760405163433fc33d60e01b815260040160405180910390fd5b5050565b60408201516001600160801b03161515806121bb575060208201516001600160801b031615155b1561219057816040516335a2be7360e21b815260040161065d9190613846565b5f611c0f8383612889565b6040516001600160a01b038085166024830152831660448201526064810182905261094e9085906323b872dd60e01b906084016117de565b336001600160a01b0382160361224757604051636d6c4ee560e11b815260040160405180910390fd5b5f80546001600160a01b0319166001600160a01b03838116918217835560015460405192939116917fed8889f560326eb138920d842192f0eb3dd22b4f139c87a2c57538e05bae12789190a350565b5f6122ea826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166128d59092919063ffffffff16565b8051909150156109cc5780806020019051810190612308919061367c565b6109cc5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161065d565b61237081610b7c565b612398576040516354c8163f60e11b81526001600160401b038216600482015260240161065d565b600480546040516383826b2b60e01b81526001600160401b038416928101929092523360248301526001600160a01b0316906383826b2b90604401602060405180830381865afa1580156123ee573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612412919061367c565b61175f5760405163728fe07b60e01b815233600482015260240161065d565b6001600160401b0382165f90815260076020526040902061219090600201827f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e6128e3565b5f611c0f836001600160a01b038416612669565b5f611c0f836001600160a01b038416612889565b7f00000000000000000000000000000000000000000000000000000000000000001561175f576124cf600282612b23565b61175f576040516368692cbb60e11b81526001600160a01b038216600482015260240161065d565b61250081610b7c565b612528576040516354c8163f60e11b81526001600160401b038216600482015260240161065d565b6004805460405163a8d87a3b60e01b81526001600160401b038416928101929092526001600160a01b03169063a8d87a3b90602401602060405180830381865afa158015612578573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061259c9190613854565b6001600160a01b0316336001600160a01b03161461175f5760405163728fe07b60e01b815233600482015260240161065d565b6001600160401b0382165f90815260076020526040902061219090827f000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e6128e3565b6060815f01805480602002602001604051908101604052809291908181526020018280548015610ffd57602002820191905f5260205f20905b81548152602001906001019080831161264a5750505050509050919050565b5f8181526001830160205260408120548015612743575f61268b600183613809565b85549091505f9061269e90600190613809565b90508082146126fd575f865f0182815481106126bc576126bc6132bf565b905f5260205f200154905080875f0184815481106126dc576126dc6132bf565b5f918252602080832090910192909255918252600188019052604090208390555b855486908061270e5761270e61386f565b600190038181905f5260205f20015f90559055856001015f8681526020019081526020015f205f90556001935050505061062e565b5f91505061062e565b5f61276a8561275b84866137d1565b6127659087613883565b612b44565b95945050505050565b81545f9061278e90600160801b900463ffffffff1642613809565b905080156127ec57600183015483546127c0916001600160801b03808216928116918591600160801b9091041661274c565b83546001600160801b03919091166001600160a01b031990911617600160801b4263ffffffff16021783555b60208201518354612809916001600160801b039081169116612b44565b835483511515600160a01b0274ff00000000ffffffffffffffffffffffffffffffff199091166001600160801b039283161717845560208301516040808501518316600160801b0291909216176001850155517f9ea3374b67bf275e6bb9c8ae68f9cae023e1c528b4b27e092f0bb209d3531c1990612109908490613846565b5f8181526001830160205260408120546128ce57508154600181810184555f84815260208082209093018490558454848252828601909352604090209190915561062e565b505f61062e565b60606108d384845f85612b59565b8254600160a01b900460ff1615806128f9575081155b1561290357505050565b825460018401546001600160801b03808316929116905f9061293290600160801b900463ffffffff1642613809565b9050801561299e578183111561295b57604051634b92ca1560e11b815260040160405180910390fd5b600186015461297f90839085908490600160801b90046001600160801b031661274c565b865463ffffffff60801b1916600160801b4263ffffffff160217875592505b84821015612a09576001600160a01b0384166129d75760405163f94ebcd160e01b8152600481018390526024810186905260440161065d565b604051630d3b2b9560e11b815260048101839052602481018690526001600160a01b038516604482015260640161065d565b84831015612ab957600186810154600160801b90046001600160801b0316905f908290612a369082613809565b612a40878a613809565b612a4a9190613883565b612a5491906137b2565b90506001600160a01b038616612a87576040516302a4f38160e31b8152600481018290526024810186905260440161065d565b604051636864691d60e11b815260048101829052602481018690526001600160a01b038716604482015260640161065d565b612ac38584613809565b86546fffffffffffffffffffffffffffffffff19166001600160801b0382161787556040518681529093507f1871cdf8010e63f2eb8384381a68dfa7416dc571a5517e66e88b2d2d0c0a690a9060200160405180910390a1505050505050565b6001600160a01b0381165f9081526001830160205260408120541515611c0f565b5f818310612b525781611c0f565b5090919050565b606082471015612bba5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161065d565b5f80866001600160a01b03168587604051612bd59190613896565b5f6040518083038185875af1925050503d805f8114612c0f576040519150601f19603f3d011682016040523d82523d5f602084013e612c14565b606091505b5091509150612c2587838387612c30565b979650505050505050565b60608315612c9e5782515f03612c97576001600160a01b0385163b612c975760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161065d565b50816108d3565b6108d38383815115612cb35781518083602001fd5b8060405162461bcd60e51b815260040161065d9190612dbe565b508054612cd9906132d3565b5f825580601f10612ce8575050565b601f0160209004905f5260205f209081019061175f9190612d1b565b5080545f8255905f5260205f209081019061175f91905b5b80821115612d2f575f8155600101612d1c565b5090565b5f60208284031215612d43575f80fd5b81356001600160e01b031981168114611c0f575f80fd5b5f60208284031215612d6a575f80fd5b5035919050565b5f5b83811015612d8b578181015183820152602001612d73565b50505f910152565b5f8151808452612daa816020860160208601612d71565b601f01601f19169290920160200192915050565b602081525f611c0f6020830184612d93565b6001600160a01b038116811461175f575f80fd5b5f60208284031215612df4575f80fd5b8135611c0f81612dd0565b5f60208284031215612e0f575f80fd5b81356001600160401b03811115612e24575f80fd5b82016101008185031215611c0f575f80fd5b80356001600160401b0381168114612e4c575f80fd5b919050565b5f805f60408486031215612e63575f80fd5b612e6c84612e36565b925060208401356001600160401b0380821115612e87575f80fd5b818601915086601f830112612e9a575f80fd5b813581811115612ea8575f80fd5b876020828501011115612eb9575f80fd5b6020830194508093505050509250925092565b5f8083601f840112612edc575f80fd5b5081356001600160401b03811115612ef2575f80fd5b6020830191508360208260051b8501011115612f0c575f80fd5b9250929050565b5f805f8060408587031215612f26575f80fd5b84356001600160401b0380821115612f3c575f80fd5b612f4888838901612ecc565b90965094506020870135915080821115612f60575f80fd5b50612f6d87828801612ecc565b95989497509550505050565b5f8060408385031215612f8a575f80fd5b8235612f9581612dd0565b946020939093013593505050565b5f60208284031215612fb3575f80fd5b611c0f82612e36565b5f60208284031215612fcc575f80fd5b81356001600160401b03811115612fe1575f80fd5b820160a08185031215611c0f575f80fd5b602081525f82516040602084015261300d6060840182612d93565b90506020840151601f1984830301604085015261276a8282612d93565b5f60208083016020845280855180835260408601915060408160051b8701019250602087015f5b8281101561307f57603f1988860301845261306d858351612d93565b94509285019290850190600101613051565b5092979650505050505050565b602080825282518282018190525f9190848201906040850190845b818110156130cc5783516001600160a01b0316835292840192918401916001016130a7565b50909695505050505050565b602080825282518282018190525f9190848201906040850190845b818110156130cc5783516001600160401b0316835292840192918401916001016130f3565b634e487b7160e01b5f52604160045260245ffd5b60405160a081016001600160401b038111828210171561314e5761314e613118565b60405290565b604051601f8201601f191681016001600160401b038111828210171561317c5761317c613118565b604052919050565b801515811461175f575f80fd5b80356001600160801b0381168114612e4c575f80fd5b5f606082840312156131b7575f80fd5b604051606081018181106001600160401b03821117156131d9576131d9613118565b60405290508082356131ea81613184565b81526131f860208401613191565b602082015261320960408401613191565b60408201525092915050565b5f805f60e08486031215613227575f80fd5b61323084612e36565b925061323f85602086016131a7565b915061324e85608086016131a7565b90509250925092565b5f60208284031215613267575f80fd5b5051919050565b5f808335601e19843603018112613283575f80fd5b8301803591506001600160401b0382111561329c575f80fd5b602001915036819003821315612f0c575f80fd5b818382375f9101908152919050565b634e487b7160e01b5f52603260045260245ffd5b600181811c908216806132e757607f821691505b60208210810361330557634e487b7160e01b5f52602260045260245ffd5b50919050565b81835281816020850137505f828201602090810191909152601f909101601f19169091010190565b6001600160401b0384168152604060208201525f61276a60408301848661330b565b602081525f6108d360208301848661330b565b5f823561011e1983360301811261337d575f80fd5b9190910192915050565b5f82601f830112613396575f80fd5b81356001600160401b038111156133af576133af613118565b6133c2601f8201601f1916602001613154565b8181528460208386010111156133d6575f80fd5b816020850160208301375f918101602001919091529392505050565b5f6101208236031215613403575f80fd5b61340b61312c565b61341483612e36565b81526020808401356001600160401b0380821115613430575f80fd5b9085019036601f830112613442575f80fd5b81358181111561345457613454613118565b8060051b613463858201613154565b918252838101850191858101903684111561347c575f80fd5b86860192505b838310156134b657823585811115613498575f80fd5b6134a63689838a0101613387565b8352509186019190860190613482565b80878901525050505060408601359250808311156134d2575f80fd5b50506134e036828601613387565b6040830152506134f336606085016131a7565b60608201526135053660c085016131a7565b608082015292915050565b601f8211156109cc57805f5260205f20601f840160051c810160208510156135355750805b601f840160051c820191505b81811015611678575f8155600101613541565b81516001600160401b0381111561356d5761356d613118565b6135818161357b84546132d3565b84613510565b602080601f8311600181146135b4575f841561359d5750858301515b5f19600386901b1c1916600185901b17855561360b565b5f85815260208120601f198616915b828110156135e2578886015182559484019460019091019084016135c3565b50858210156135ff57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b8051151582526020808201516001600160801b039081169184019190915260409182015116910152565b5f6101006001600160401b038716835280602084015261365f81840187612d93565b91505061366f6040830185613613565b61276a60a0830184613613565b5f6020828403121561368c575f80fd5b8151611c0f81613184565b634e487b7160e01b5f52601160045260245ffd5b60ff828116828216039081111561062e5761062e613697565b600181815b808511156136fe57815f19048211156136e4576136e4613697565b808516156136f157918102915b93841c93908002906136c9565b509250929050565b5f826137145750600161062e565b8161372057505f61062e565b816001811461373657600281146137405761375c565b600191505061062e565b60ff84111561375157613751613697565b50506001821b61062e565b5060208310610133831016604e8410600b841016171561377f575081810a61062e565b61378983836136c4565b805f190482111561379c5761379c613697565b029392505050565b5f611c0f60ff841683613706565b5f826137cc57634e487b7160e01b5f52601260045260245ffd5b500490565b808202811582820484141761062e5761062e613697565b6001600160401b0383168152604060208201525f6108d36040830184612d93565b8181038181111561062e5761062e613697565b6001600160401b038416815260e081016138396020830185613613565b6108d36080830184613613565b6060810161062e8284613613565b5f60208284031215613864575f80fd5b8151611c0f81612dd0565b634e487b7160e01b5f52603160045260245ffd5b8082018082111561062e5761062e613697565b5f825161337d818460208701612d7156fea2646970667358221220ca42d72bbc2c13e408cb23f2fd2c2366f7e2eed37043c109ab8ac568e0e89e2464736f6c63430008180033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000411de17f12d1a34ecc7f45f49844626267c75e81000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080226fc0ee2b096224eeac085bb9a8cba1146f7d0000000000000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : token (address): 0xC4441c2BE5d8fA8126822B9929CA0b81Ea0DE38E
Arg [1] : localTokenDecimals (uint8): 18
Arg [2] : allowlist (address[]):
Arg [3] : rmnProxy (address): 0x411dE17f12D1A34ecC7F45f49844626267c75e81
Arg [4] : acceptLiquidity (bool): False
Arg [5] : router (address): 0x80226fc0Ee2b096224EeAc085Bb9a8cba1146f7D
-----Encoded View---------------
7 Constructor Arguments found :
Arg [0] : 000000000000000000000000c4441c2be5d8fa8126822b9929ca0b81ea0de38e
Arg [1] : 0000000000000000000000000000000000000000000000000000000000000012
Arg [2] : 00000000000000000000000000000000000000000000000000000000000000c0
Arg [3] : 000000000000000000000000411de17f12d1a34ecc7f45f49844626267c75e81
Arg [4] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [5] : 00000000000000000000000080226fc0ee2b096224eeac085bb9a8cba1146f7d
Arg [6] : 0000000000000000000000000000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 34 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|---|---|---|---|---|
| ETH | 100.00% | $0.028347 | 162.5806 | $4.61 |
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.